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VAC oDK a available for | 
RASPBERRY PI! 


With VNC SDK you can connect VNC Viewers with VNC Servers } 
easily over the Internet. Using VNC Cloud, no complicated 
network configuration at either end is required! 


What will you create with VNC SDK? 


Check it out here: https://developer.realvnc.com/ 


Getting connected: www.realvnc.com/products/vnc/raspberrypi/ 
For more information contact vncdeveloper@realvnc.com 
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PI MAGAZINE! — : 


he Raspberry Pi Camera Module is one of the 
most popular add-ons for the Raspberry Pi. 
Released in 2013, it made use of the previously 
dormant CSI connector, spawned a whole new genre 
of amazing Raspberry Pi projects, and has since found 
itself everywhere from the depths of the ocean to the 
dizzy heights of the International Space Station. 


Its 5MP sensor was equivalent to the kind of standard . — 
cameras you’d find on smartphones of the time, but rath 
Since three years is an eternity in technology, Raspberry ae ee 
Pi have just released a shiny new update. You can learn SEE PAGE 34 FOR DETAILS Sav Sa é : =u aaa 


all about the new camera Starting on page 20, where 
we speak to its creators about its new specification, 
which includes a rather splendid 8MP Sony sensor. 
While the means of taking pictures and video remains THIS MONTH: 
unchanged from the original Camera Module, we’ve 
included everything you need to do to get started, as 
well as a number of fun and useful projects to get you 
snap-happy in no time at all. 

If you’re a subscriber, you’1l already have received a 52 MAKE A HUMIDITY SENSOR 


special code that entitles you to skip to the front of the 
purchase queue at ThePiHut.com. Not yet a subscriber? 


It’s not too late to make use of this fantastic offer — see 66 RETRO GAMING GREATNESS 


20 THE CAMERA MODULE V2 ARRIVES 


Get the low-down on the new hardware & start a project today 


Replicate one of the best Astro Pi projects, as found on the ISS 


page 34 for details! Learn about our ten favourite arcade cabinet projects 
Russell Barnes 95 WIN A CAMERA MODULE V2 
Managing Editor We've got ten of the new cameras to give away! 
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TUTORIALS 


> PI-THERMOMETER 46 


Build your own internet-based LED thermometer 


> PREDICTABLE NETWORKING 48 


Give your Raspberry Pi a network address of its own 


> MAKE ASTEROIDS IN BASIC 00 


Build your own clone using FUZE Basic 


> SCIENCE WITH THE SENSE HAT 82 


Create one of the experiments being used on the ISS! 


> SAMPLE SLICING IN SONIC PI 54 


Join Sam Aaron for part 10 of his music-coding series 


> RASPBERRY PI ACCESS POINT 56 


Using the PaPiRus E-Ink display 


> MIKE’S PI BAKERY: GET A GRIP 58 


Make a music sequence with hairgrips! 


> CREATE NEOPIXEL EYES 64 


Build an impressive costume with the help of Raspberry Pi 


IN THE NEWS 


Astro P1 coding challenge 


The results are in and your musical masterpieces are 
ready for the ISS crew to listen to! 
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Camera V2.1 


THE NEW PI CAMERA 


Take better pictures and video with the Raspberry Pl Camera Module V2 


Dino Hack 


Blackgang Chine has renovated 
some animatronic dinosaurs with 
the help of the Raspberry Pi 
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The CoderDojo Foundation is 


benefiting from VMware Foundation 


support. Here's how... 
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Follow in the footsteps of these 10 amazing projects to bring a slice 
of retro gaming nirvana into your own home 


PI MOON CAMERA 


James Mitchell shows off his excellent Raspberry Pi camera project 


Mars Rover 


This Pi enthusiast aimed for the stars 
when building his Raspberry Pi robot 


Model Railway 


Dorset’s model village turned to the Pi 
to power their awesome railway 


Cat Wheel 


Get your moggy moving with this excellent 
exercise apparatus built for a feline friend 


raspberrypi.org/magpi 


i 
_ 
e 
oe 
a 

a 
ce 
- 
o 

a 


: ve 
a 
RED -106-8- 10 ® 


This home-made submersible : 
drone will take your breath away 


REGULARS 


> NEWS 06 
The biggest stories from the world of Raspberry Pi 

> TECHNICAL FAQ 72 
Got a problem? Maybe we can help... 

> BOOK REVIEWS 80 
The best reads for coders and hackers 

> THE FINAL WORD 96 


More musings from Raspberry Pis own Matt Richardson 


THIS MONTH IN PI 82 
Find out what else has been happening in the community 
SEA OF ROBOTS 86 
Building an Al swarm of boats using the Raspberry Pi 
EVEN LS 88 
Get involved in a community gathering near you! 
YOUR LETTERS 92 


Talk to us about the magazine (or anything you like!) 


DRUM HAT 74 
PICON ZERO 76 
WYLIODRIN STUDIO 78 
NUCLEUS ZERO CASE 79 
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CODING CHALLENGE 


What music will Tim Peake and the rest of the ISS crew be listening to in space? 


he Raspberry Pis may 

already be up in space 

performing experiments, 
but it doesn’t mean the end for 
the coding portion of Astro Pi. 
Over the last few months, some 
intrepid young coders have been 
creating music and MP3 players to 
send up to the Astro Pis orbiting 
Earth, and recently it was finally 
time to judge the efforts of these 
amazing young people from around 
the country. 

Judging was split over two days, 
with the MP3 players chosen first 
after an all-day session, and the 
Sonic Pi tracks compared on the 
second full day. Among the judges 
were members of the ESA, the 
Royal Institute, and even Andy 
McCluskey and Paul Humphreys 


from British new wave band 
Orchestral Manoeuvres in the 
Dark. The judges on both days were 
accompanied by Dave Honess of 
the Raspberry Pi Foundation, who 
has been at the core of Astro Pi 
from the very beginning. 

“The judging was great fun,” 
Dave tells us. “This competition 
differed from the previous, more 
open-ended one, in that students 
were given a specific brief to code 
to. The MP3 player challenge gave 
rise to lots of different approaches 
to the same task, which was 
really interesting to see. Where 
do you put the play/stop buttons? 
How does the heads-up display 
work? Do you put waveforms 
and VU meters in for fun°® Some 
of them were really complex to 


operate, which shows that coding 
a program that’s simple and 
elegant is not as straightforward 
as it sounds. The ones that 

won all nailed the simplicity 

and functionality in exactly 

the right place. 

“The Sonic Pi tunes were really 
good, too. Many of them were 
simple beats and electronic 
sounds with a Kraftwerk-cum- 
Giorgio [Moroder] vibe. We had 
one song that was composed 
almost entirely of burp samples, 
which had us all in stitches! Shout 
out to Anchorsholme Academy 
Code Club for that one. My 
favourite track, though, was Piano 
Pi from Bartholomew Secondary, 
which had an old-school Ace of 
Base Nineties sound.” 
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11 AND UNDER 
Jude Young 


SCHOOL: 
Clifton College 
Preparatory School 


SUPERVISOR: 
Andrew Young 


magpi.cc/1Vjumff 


11 TO 13 
Lowena Hull 


SCHOOL: 
Portsmouth 
High School 


SUPERVISOR: 
Gary Barrows 


magpi.cc/1VjvXlm 


14 TO 16 
Joe Speers 


SCHOOL: 
N/A, 
independent entry 


SUPERVISOR: 
Craig Speers 
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17 TO 18 
Marcus Panchal 


SCHOOL: 
Lancaster Royal 
Grammar School 


SUPERVISOR: 
Sanjay Panchal 


magpi.cc/1Vjw4gH 
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To ensure fairness, the 
entries were anonymous when 
presented to the judges, and 
a special scoring system was 
used that was then aggregated 


Bristol, who sounded like he was 
doing a million fist pumps per 
minute. Having your code flown 
to the International Space Station 
and used by an actual astronaut 


The MP3 player challenge 
gave rise to lots of different 
approaches to the same task 


to reveal the winners. They 
were then contacted to let 
them know the good news. 

“We phoned them all before 
the announcement was made on 
our blog,” Dave continues. “The 
best reaction I had was Jude Young 
from Clifton College Prep in 


carecor”’: SIS. 


The music from all the entrants 
is available on SoundCloud if 
you want to dance along to some 
space tunes (see links below). 
Dave assures us there will be 
more competitions to come in the 
future as well. So if you missed 
out this time, don’t lose hope. 


is quite a profound thing for 

a young coder! We’ve seen, 

in both competitions, that this 

is the single biggest motivating 
factor for participation in Astro 
Pi. So it’s basically gone down as 
a huge confidence boost for them, 
and rightly so.” 
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11 AND UNDER 


Iris and Joseph Mitchell 


SCHOOL: 
Southend 
Raspberry Jam 


SUPERVISOR: 
Andy Melder 


magpi.cc/1VjweVA 


11 TO 13 
Isaac Ingram 


SCHOOL: 
Knox Academy 


SUPERVISOR: 
Karl Ingram 
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14 TO 16 
Jamie Andrews 


SCHOOL: 
Bartholomew 
Secondary School 


SUPERVISOR: 
Jason Andrews 


magpi.cc/1VjwnrS 


17 T0 18 
Pinal Parmar 


SCHOOL: 
Featherstone 
Sixth Form 


SUPERVISOR: 
Beena Parmar 


magpi.cc/1VjwoME 
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Coolest Projects is an annual event which 
showcases digital projects, created in 
Dojos globally, in one unique space 


BENEFITS FROM VMWARE 
FOUNDATION SUPPORT 


The VMware Foundation has donated a total of 960 Raspberry Pis to CoderDojo 
to be distributed to Dojos around the world. Ross O’Neill tells us more... 
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“The very generous 

donation by VMware of 

over 900 Pis to kids in the 

CoderDojo community 

was very gratefully 

received. The Pis have been distributed to kids 
aged between 7 and 17 around the world, enabling 
them to explore, create, and build with a fun new 
device. Raspberry Pis are cool and easy to use; the 
kids have adopted them really easily, and have 
incorporated them into projects they're working on. 
Introducing kids to all possible forms of technology 
taps into their natural curiosity and creativity, and 


we have experienced just that with the sharing of 
the Pis funded by VMware!” 


MagPi May 2016 


oderDojo is a global 

movement of free, 

volunteer-led, 
community-based programming 
clubs for young people. At a Dojo, 
youngsters between the ages of 
7 and 17 learn how to code; play 
with Pis; develop websites, apps, 
programs, and games; and explore 
technology in an informal and 
creative environment. In addition 
to learning to code, attendees 
meet like-minded people and are 
exposed to the possibilities of 
technology. Within the CoderDojo 
movement there is a focus on 
community, peer learning, youth 
mentoring, and self-led learning, 
with an emphasis on showing how 
coding is a force for change in 


the world. The global CoderDojo 
community is supported by the 
CoderDojo Foundation. 

The CoderDojo movement 
was originally founded by James 
Whelton and Bill Liao. It all started 
in James Whelton’s school in 
early 2011, when James (then an 
18-year-old coder) received some 
publicity after hacking the iPod 
Nano. As a result, some younger 
students expressed an interest in 
learning how to code. James set 
up acomputer club in his school, 
where he started teaching students 
basic HTML and CSS. Later that year 
he met Bill Liao, an entrepreneur 
and philanthropist, who was 
interested in growing the project 
into something bigger. 
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James Whelton co-founded the 
CoderDojo Foundation when he was 
just 18 years old 


How did it begin? 
Back in July 2011, the first CoderDojo 
was launched in the National 
Software Centre in Cork, Ireland. 
The Dojo was so popular that people 
frequently travelled over 250km 
from Dublin to attend sessions. 
Owing to this popularity, James 

and Bill open-sourced the model 
and encouraged growth. Soon 
afterwards, a Dojo in Dublin was 
launched, followed by more clubs 


first CoderDojo, James Whelton, 
the Foundation is focused on 
supporting new and existing Dojos 
through resource and community 
development, while also scaling 
CoderDojo through partnerships 
and raising awareness globally. 


How will Pis help Dojos? 
Raspberry Pi is a capable little device 
that enables people of all ages 

to explore how computers work 


Created content specifically 
for Dojos using Raspberry Pis 


across Ireland, before expanding 
outside the region. Through 

making the movement open- 
source, thousands of dedicated 
Champions (those who set up Dojos) 
and Mentors have created more 
Dojos across the world, making 

the CoderDojo movement a global 
phenomenon. As of April 2016, there 
are now over 900 verified Dojos in 
65 countries, and the number is 
erowing all the time. The CoderDojo 
Foundation consists of a core team 
based primarily in Dublin. Founded 
by the co-founder of the very 
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and to learn how to program in 
languages like Scratch and Python, 
two of the most popular languages 
taught at Dojos. It’s capable of 
doing everything you’d expect 

a desktop computer to do, from 
browsing the internet and playing 
high-definition video to playing 
games. What makes the Raspberry 
Pi so popular within a Dojo context, 
however, is that it has the ability 
to interact with the outside world, 
and has been used in a wide array of 
digital projects. On top of this, the 
CoderDojo Foundation has created 


CODERDGJO FOUNDATION 


content within its Sushi Card 


: sinner et : The Docklands 
series specifically for Dojos using Dojo in full swing 
Raspberry Pis. at Dogpatch Labs, 

. a Dublin co-working 
The VMware Foundation has space where 
donated a total of 960 Raspberry the CoderDojo 


Pis to CoderDojo, to be distributed Foundation is based 


to active Dojos around the world. 

So far, the CoderDojo Foundation 
has sent out 480 of these to Dojos 
elobally, with the rest being shipped 
this coming month. It’s hoped 

that all these Raspberry Pis will 
encourage kids to program. They will 
also be used to create digital projects 
for the upcoming ‘Coolest Projects’ 
event at the Royal Dublin Society, 
where an expected 10,000 attendees 
will be visiting this June, all in the 
name of having fun with code. 


How do | join? 
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HACKING WITH 


British amusement park Blackgang Chine wanted to improve its Pi- powered 


dinos, so Dr Lucy Rogers put on a conference to do just that 
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One of the pieces of tech that makes all of the 
animatronics and such compatible with the 
Raspberry Pi at Blackgang Chine is Airborne 
Engineering's Touchbridge system, a HAT for the 
Pi which can control additional hardware buses. 
This allows the Raspberry Pi to control 24-volt, 
16-amp motors. Even though it only outputs 3V3 
at 10 milliamps at the GPIO. 62 buses can be 
daisy-chained together, each with eight inputs or 


outputs, so you can control a fair number of motors 
with the right code and power requirements. 


MagPi May 2016 


ou may recall a video from 
! acouple of years ago, of 
Dr Lucy Rogers showing 
you around Blackgang Chine’s 
dinosaurs (blackgangchine.com), 
which had recently become 
powered by a Raspberry Pi or two. 
It was a great video that captured 
the imagination and showed just 
what the Raspberry Pi could do. 
Now, in 2016, the Raspberry Pis 
powering the dinos have received 
an upgrade; this is in no small 
part thanks to Lucy anda team 
of people she brought together 
for a conference-style Raspberry 
Jam, called Blackgang Pi, over 
the course of a weekend on the 
Isle of Wight. 
We decided to visit and see just 
how the conference was going, 
so ona misty Sunday morning we 
made our way to Blackgang Chine 
to see the team in action. It’s the 
UK’s oldest amusement park and 


while it does have a couple of 


remarkable Victorian-era dinosaur 


Statues, the dinosaurs that were 
being hacked today were much 
newer than that. A tea room at 
the park had been taken over by 
the team during Blackgang’s off 
season and had been turned into 
a little workshop, with people 
working on electronics and 
animatronics, using Raspberry 
Pis interfaced with old and 

new components. The original 
Raspberry Pi upgrades that Lucy 
had done a couple of years before 
had worked fine. Due to weather 
damage, however, they’d begun 
to develop a couple of problems 
at the end of the last season and 
a further, more robust upgrade 
was in order. 

It wasn’t just dinosaurs that 
were being hacked either: one 
project was looking at how some 
of the electrics in Blackgang 


raspberrypi.org/magpi 


Take our word for it: the electronics ina 
control box just like this operate a T. Rex 


Chine, and the neighbouring 
Robin Hill adventure park, 


could be controlled via a Raspberry 


Pi. Sometimes when there’s 

an issue at Robin Hill, it might 

require a 20-mile walk, so a Pi- 

controlled system would help to 

reduce these sorts of issues. 
Another major part of the 

conference was the use of 


be easier to understand for some 
people and it’s useful for IoT or, 
apparently, dinosaurs. 

By the time you read this, the 
park will have been reopened to 
visitors, including access to these 
upgraded dinosaurs. There’s also 
going to be another Blackgang 
Pi event, a one-day Raspberry 
Jam this time, that’s happening 


Electronics and animatronics, 
using Raspberry Pis interfaced 
with old and new components 


Node-RED (nodered.org). 

We’ ve had a couple of tutorials 
for it in the magazine before, 
such as Minecraft in the Mashups 
issue and our hamster feeder 
from last issue; it’s a visual 
programming language that, 
instead of writing code, has you 
building up blocks that create the 
program in a type of flow. It can 
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in early June; you can read all 
about it on the Events pages at 
the end of the magazine. As well 
as getting involved and maybe 
showing off your Raspberry Pi 
projects, like any other Jam, you 
might be able to take a quick 
break and enter the park itself 
to see the dinosaurs in person. 
Don’t worry: they don’t bite. 


The deinonychus is the closest thing in the prehistoric world 
to the velociraptors from Jurassic Park. Raptors in real life 
were about the size of turkeys, while deinonychus were 
much more of the real deal. The ones in Blackgang Chine 
are quite tame, however, as you round a bend and see them 
lolling around an open space. Don't get distracted, though: 
while your attention is drawn by them, a motion sensor will 
reveala hidden member of the pack right next to you. 


The tyrannosaurus rex has ingrained itself pretty firmly 

in popular culture as one of the greatest predators ever, 
and it’s not hard to see why when you come face-to-face 
with a life-size adult at Blackgang Chine. The T. Rex here 
won't chase anyone holding a flare, but it will roar at 

you, shaking the viewing platform as it does (thanks to 
the speakers). A big, mean dinosaur powered by a little 
Raspberry Pi: it's not something you see every day. 
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This family of triceratops is pretty cute, with parent 

and child moving and interacting with each other. 

Lucy always seems particularly pleased by this display, 
and after seeing some of the more ferocious predators 
Blackgang Chine has to offer, it’s nice to see a calm 
family of herbivores just going about their business 
and having some lunch. 
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THE RASPBERRY PI 
ORACLE WEATHER 
STATION IS HERE 


Not to be outshone by the camera, the weather stations 


ON SALE YET? 


The kits so far 


are just for the 


schools that 


signed up for 


the scheme. 
However, the 
Raspberry Pi 


Foundation is 


looking at a way 


to make them 
commercially 


available to 


other schools, 


and also to 
individuals. 
Keep an eye 
on this space 
for when we 


know more! 


Cn 
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for schools have been delivered. Time for science! 


tarting all the way back 
in 2014, the Raspberry Pi 
Oracle Weather Station 
project was set up to give away 
1,000 weather station kits to 
schools. Each one would be 
powered by a Raspberry Pi, and 
enable students to perform any 
number of weather-related 
experiments. Two years on, and 
the first batch of weather stations 
has just been shipped. 

This first set of Oracle weather 
Station kits has been supplied 
to 150 UK schools, with further 
Stations to be sent out around the 
globe once feedback has begun 
to be processed. Now students 
can Start learning code and 
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meteorology through various 
subjects, and study how the 
weather works using much more 
interactive and exciting methods. 

As feedback comes back and 
the rest of the units are shipped 
out worldwide, more and more 
learning resources will also be 
made available, so that schools 
and students have something to 
work towards while using their 
new weather station. 

Whether you have a weather 
Station or not, you can always 
join the community for it. 
There’s a dedicated section 
of the Raspberry Pi forum for 
everything to do with the kit here: 
magpi.cc/iquWtLg 


SPECS 


CONTROLLER: 
Raspberry Pi 


FORMAT: 
Hardware Attached on Top 
(HAT) with a real-time clock 


SENSORS: 

Basic sensors: humidity, 

temperature, air quality, 

and barometric pressure 


Rain gauge: measures 
the amount of rainfall in 
~0.3mm increments 


Anemometer: a wind speed 
gauge to keep track of 
whether you're in a gentle 
breeze or gale 


2» Follow 


B, BWoodhead Primary ts 


Wind vane: it may not have 


Code club students building a weather station 
kindly donated by the @Raspberry_Pi 
foundation thanks @clivebeale 


Super exciting raspberry pi weather station a rooster on it, but it will still 
arrived, very lucky to be one of the 150 uk 


schools @rasberrypi 


show you wind direction 


Temperature probe: a basic 
probe that can measure 
ambient temperature in 
Celsius, accurate to three 
decimal places 


Far left The students at Durham 
Johnston waste no time getting 
the kit set up for use 


Left Burley Woodhead Primary 
School are also starting to get their 
new science experiments ready 
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Raspberry Pi gets a new home 


Industrial automation with Raspberry Pi just got easier 


The new RPI-BC enclosure is desgined specifically to accomodate Raspberry Pi 
computers. The DIN rail or wall mountable enclosure provides access to all ports, 
GPIO pins and SD card without removing the lid. Ideal for all industrial automation 


projects. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk 


INSPIRING INNOVATIONS 


Howard helps to install new solar panels at Bbakasa primary school 


in the Siavonga district of Zambia 


AN 


An enthusiastic response from pupils at Kabbila 
school, keen to learn all about the Raspberry Pi 


and Scratch programming 


\), 
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ADVENTURE 


Introducing Raspberry Pi into rural Zambian schools with no electricity supply? 
We talk to the founders of the Siavonga Project to discover how it’s done... 


14 


Initially, an 80W Baird solar panel was chosen to 
supply power at each school, via a heavy-duty 
deep cycle battery (the sort used in caravans 

and motorhomes). Panels and batteries were 
purchased in Zambia, due to weight restrictions 
for air freight. A solar charge controller is used to 
prevent overcharging and enable the battery state 
to be monitored. Since the power supplied is 12V, 
a step-down regulator is used to convert it to 5V 
for the Pis. On later visits, 135W solar panels were 
installed, along with a 220Ah battery, enabling the 


system to also power LED lighting. 
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hen asked to design a 

website for the Swansea 

Siavonga Partnership 
charity, Harold and Wendy Kirkman 
of Giakonda IT asked whether the 
rural schools in Southern Zambia 
had computers. “No, would you like 
to install them?” was the response, 
recalls Wendy. “Then they dropped 
the bombshell that many schools 
had no mains power!” 

Wendy and Howard soon realised 
the Raspberry Pi would be ideal 
for the project, which enables 
teachers to deliver the Zambian 
ICT curriculum in schools where 
children have previously never even 
seen a computer or mouse. As well 
as being cheap and portable, the 
Pi requires low power and can run 
off batteries. It also offers a wealth 
of educational resources. 

Since the first two primary 
schools set to benefit from the 
project had no mains power, 
Wendy and Howard chose to use 
solar panels. Before heading out to 


Zambia, they tested the setup at 
the rear of their premises: “[We] 
managed to run two Pis with two 
[portable] monitors, during the 
whole of December in Swansea!” 
They were naturally confident, then, 
that it would work in Zambia, where 


there’s a little more sunshine! 


Memorable school trip 
During their first trip to Siavonga 

in January 2015, Wendy and Howard 
spent nearly a month setting up 
computers in two rural primary 
schools: Bbakasa and Matuwa. After 
installing the solar power system 
for each, they could get down to 

the business of demonstrating the 
Raspberry Pi in the classroom. 

“As well as setting up equipment, 
we provide training for teachers 
and pupils,” Wendy explains. 

“This is a vital part of the project 
in order to give them confidence 
in using Raspberry Pi. Howard and 
I are trained teachers... He taught 
computer science for many years.” 
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This process enables the Zambian 
teachers to teach ICT to children 
who are completely unfamiliar with 
computers. “They use LibreOffice 
on the Raspberry Pis for word 
processing and spreadsheets. 

The students particularly enjoy 
programming with Scratch.” 

While the original Raspberry Pi 
Model B was used initially, they 
have since installed the Pi 2 and, 
more recently, Pi3: “The addition of 
wireless to this model saves money 
- and lost dongles.” Since few of the 
schools have internet access, several 
Pis have been set up as Servers 
to deliver the Khan Academy and 
RACHEL e-learning resources, ona 
64GB card, to a hub of computers. 


Technical troubles 

While Wendy and Howard have each 
made two visits to Zambia, 21-year- 
old Connor Smith represented 
Giakonda on the latest trip in spring 
2016. “Reinforcing their knowledge 
on how to use the Pi and the 
software provided was the first thing 


Connor Smith solved many technical issues 
and installed more Raspberry Pis during his 
recent trip to schools in Siavonga 


that needed to be done,” he tells 
us. “Even the simplest things like 
corrupt Raspbian SD cards and faulty 
USB power supplies, which would 
be an easy fix in UK, provided real 
challenges in rural Zambia.” 
Fortunately, he was aided by local 
volunteer Bridget Muyuni, who 
was tasked with taking care of the 
systems put in place. “While I was 
there, I went over the most common 
issues with her. In many cases, we 
had to improvise and make do.” 
Solving the technical issues was 
all worth it when Connor witnessed 
the reactions of the schoolchildren: 
“Their enthusiasm for school and 
the chance for an education is what 
hit me the hardest.” When he 
gave a lesson on the basics of the 
Raspberry Pi and RACHEL, there 
was Silence at first, as the pupils 
wondered what on Earth he was 
talking about. “But as I showed 
everyone the Pi, I got some truly 
wonderful and wacky responses to 
what they thought [it] was. I then 
told them all that it was a fully 
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The Giakonda IT Raspberry Pi project has been 
funded by Hub Cymru Africa, University of Wales 
Trinity St David, and S and C Electric Europe. The 


team work closely with the not-for-profit Swansea 


Siavonga Partnership (swansea-siavonga.org), 


whose Discovery student volunteering programme 
holds workshops in Siavonga and links its schools 


to Local ones in Swansea. To find out more about 


the Giakonda Siavonga project, and possibly make 


a donation, visit: gakonda.com/siavonga. 


functioning computer and their 
jaws dropped — I’ve never been ina 
room that was so quiet, as they sat 
in disbelief and then bombarded me 
with more questions.” 

While the project has worked 
with nine schools so far, supplying 
an average of four Raspberry Pis 
per school, there are plans for 
expansion: “There are 26 schools 
in the district which don’t have 
mains power, and we plan to extend 
the programme to all of these ona 
rolling [basis]”, says Wendy. She 
and Howard will be making another 
visit in June/July, possibly followed 
by another colleague in September. 


Monitors have been an ongoing issue 
for the project. “On our first visit 
(January 2015), we used 5-volt, 9-inch 
Tontec screens and made our own 
enclosures,” says Howard. “In July, 
we used 12-inch TFT screens from 
Beetronics, but at £145 each, they 


were more than we really wanted to 


pay. As we are looking to install much 
larger numbers, we are considering 
pi-topCEED.” 
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Get the games now from 


YOYOGAMES.COM/PI 


GAMEMAKER 
GAMES ON 
RASPBERRY PI 


Three excellent video games make their way to the Raspberry Pi, 
and you can play them right now! 


MAKE GAMES WITH GAMEMAKER 


egies Geta eT TT aarti Serer 


SEP RRTI6n 8) a —— a 


GameMaker: Studio is software which runs on 


Windows that makes game development easier. 


Developed by games industry veterans and based 
ona game design teaching tool, it’s popular 
among indies and new devs thanks to a free 
version that's great to play around with, and a low 
price for a full version. It exports to a lot of major 
platforms and maybe soon it will be able to export 
to the Raspberry Pi! One day, you may even be 
able to use GameMaker: Studio on the Raspberry 
Pi as an educational tool. Check it out online here: 
magpi.cc/1RMTmJp 
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ideo games on Raspberry Pi 
have been around since day 
one. From people creating 
or upgrading arcade machines with 
the Raspberry Pi and the help of 
some emulation software, to others 
programming their own games in 
Python, it’s an established use of 
the Pi in the community. There 
haven’t been very many games 
ported to or developed natively for 
the Raspberry Pi, though. That’s 
all changed, however, thanks to 
the excellent folks at YoYo Games, 


ae Mike Dailly™ 


who have put a handful of some of 
their GameMaker: Studio classics 
on the Raspberry Pi. 

“We all know the Raspberry Pi 
is an amazing little machine, but 
it really needs to get some serious 
game developers on there to 
help get the great content that’ 1l 
drive its use,” Mike Dailly, head 
of engineering at YoYo Games, 
tells us. Mike is a British games 
industry veteran, being one of the 
original creators of Lemmings and 
Grand Theft Auto, so he knows his 


tt + Follow 


Please RT this! Need lots of opinions! 


Would you use a @Raspberry_Pi #GameMaker 


#Studio export? 
32% Yes,lo release games 


21% ‘Yes,just to play 


Pa} 


37% No, nointerest 


eres q 
ee ee 


Above Mike's Twitter poll showed that over 60% of 1,500 respondents wanted to see 
games on Raspberry Pi - a hefty number, for sure 
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OH. 


YOU DON'T NEED TO ORDER - 


YOUR PI2z2z4A*'S ALREADY OONE . 


Indie darling Hotline Miami was made in GameMaker: Studio, showing the power 


of the dev tool 


stuff. “So, in my (neverending!) 
quest to support the Pi, I went to 
some of the best indie developers 
out there and, with the promise 
of much cake, got them to let me 
use their games. These games 
are amazing in lots of ways, and 
each one pretty different from 
the next.” 

It comes a long time after the 
original Raspberry Pi launch, but 
apparently this belated release 
is not because YoYo Games 
Started on the ports recently, 
as Mike explains: 

“T’ve been trying to get 
something released on the Pi for 
years, but as 1 could only do it in 


Getting to this point may have 
taken a while, but it’s now a simple 
case of just exporting GameMaker: 
Studio projects to the Raspberry Pi, 
like the developers would for any 
other platform. There’s been a lot 
of interest from other GameMaker 
devs who want to port, whether 
themselves or straight through 
Studio, and a poll that Mike put 
on Twitter proved there was much 
wider interest in it. 

Why the Pi, though? Why has 
Mike put so much hard work 
into ite 

“Because it’s an awesome little 
machine that reminds me of the 
freedom | used to have by having a 


These games are amazing 
in lots of ways, and each one 
pretty different from the next 


my spare time, it’s taken a long 
time. The GameMaker Linux port 
came about because I first had to 
port GameMaker to Linux before 
porting it to the Pi!” The Linux 
port was a big enough task on 

its own, according to Mike, and 
then he had to find the time to 
port it to the Pi. “But while it’s 
taken a long time, I’m overjoyed 
I’ve finally got something the Pi 
community can enjoy. If nothing 
else comes from this, there 

are now three amazing games 

on the Pi - and that’s worth it 
right there.” 
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ZX81 or Spectrum in my bedroom 
when I was growing up,” Mike 
recalls fondly. “The Pi has the 
chance to bring back this unique 
learning experience, and I for one 
will do all I can to help support the 
amazing work they’re doing!” 
Now Mike wants to get the 
export option fully added into 
GameMaker: Studio. To do this, 
he needs people to download 
the games and check them out, 
which you can do by going to 
yoyogames.com/pi. Maybe one 
day you can create a game that 
works on the Raspberry Pi. 


a a 


Here are the three games you can enjoy now on your 
Raspberry Pi - yoyogames.com/pi 


= oO 


By: Jesse Venbrux 


Run and jump through 11 crazy worlds to feed the 
monsters in this 360° gravity platformer. It doesn't 
matter which way you go — up or down, left or right 
- you can't fall off because of the 360° gravity! Jump 
from rotating planes to moving platforms, avoiding 
dangers and collecting diamonds. 
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By: Vlambeer 


From the folks behind Luftrausers, grab your 
baseball cap and loosen your pants: it's time to 

fight endless hordes of enemies and collect every 
weapon crate you can. Prepare for an arcade delight 
with tight controls, refreshing game mechanics, 
cracking retro art, and a hip chiptune soundtrack. 


By: Locomalito 


Maldita Castilla (cursed/damned Castile’) is an 
action arcade game full of myths from Spain and 
the rest of Europe. The graphical style is raw, made 
pixel by pixel with a limited colour palette Like in 
the old days, and displayed through a dirty old 
monitor effect. 
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Stay up to date with our Latest news by following our social media. 
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It allows you to prototype 


and pi-topCEED. 


circuit boards, create amazing lol devices and 
more. Slide the pi-topPROTO into the modular 


rail to build any Functionality into your device. 
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SEH 


AAS ! 


Take better pictures and video with the 
upgraded version of one of our favourite 
Raspberry Pi add-ons 


he Raspberry Pi Camera price and work with every version of 
Module has always been a the Raspberry Pi, so you won’t need 
fantastic add-on forthe Pi. —_ to upgrade just to use it! 
There’s always a really fun project We’re celebrating the new release 
somewhere that makes use of it, and _ witha load of cool projects to get 
it results in a very gratifying visual you started using the new camera. 
aspect to your work. They’1l work with the old camera as 
With the new Raspberry Pi well, but we think the new one will 
Camera Module v2, these projects be well worth the upgrade; read up 
can only get better. At its most on why it’s better over the next few 
basic, it’s a better camera that can pages, as we test it and interview the 


take higher-resolution photos and people behind it. 
also has improved video recording 

capabilities. In the usual Raspberry 

Pi tradition, it will stay the same 


raspberrypl.org/magp! 
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feature 


Pl CAMERA V2 


We talk to the team behind the new 
camera to find out exactly what’s 
new with the Camera Module v2 


MagPi May 2016 


Imost exactly three years 

ago now (14 May 2013!), 

the Raspberry Pi Camera 
Module was released to the world. 
Making use of the CSI port on 
the Pi that had been sitting there 
relatively unused for over a year, 
the camera has been a small hit. 
We’ve always liked it, and so news 
of a new camera excited us. To find 
out all about the Camera Module 
v2, we spoke to James Adams, 
director of hardware at Raspberry 
Pi, and Gordon Hollingworth, 
director of software at Raspberry 
Pi, so we could cover both the 
hardware and software side of it. 


Mother of invention 

“The camera is designed to replace 
the original as closely as possible, 
as the original sensor is [End-of- 
life (EOL)],” James tells us. “So 

we had the same budget and form 
factor as the goal, with as much 
improvement in capability as that 
would permit... This new camera 
has been a background development 
task ever since we understood that 
the original sensor was EOL about a 
year ago.” 


SPECIFICATIONS 


PI CAMERA 


SENSOR: 

OmniVision OV5647 
SENSOR RESOLUTION: 

2592 «x 1944 pixels (5 megapixel) 
SENSOR IMAGE AREA: 

3.76 « 2.74 mm 

PIXEL SIZE: 

1.4 Wm «1.4 ym 

OPTICAL SIZE: 

1/4" 

VIDEO: 

1920 x 1080 (1080p), 30fps 
1280 « 720 (720p), 60fps 
640 x 480 (480p), 90fps 


PI CAMERA V2 


SENSOR: 
Sony IMX219 


SENSOR RESOLUTION: 
3280 x 2464 (8 megapixel) 


SENSOR IMAGE AREA: 
3.69 x 2.81 mm 


PIXEL SIZE: 

1.12 um x 1.12 um 

OPTICAL SIZE: 

1/4" 

VIDEO: 

1920 « 1080 (1080p), 30 fps 
1280 « 720 (720p), 60fps 
640 x 480 (480p), 90fps 
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The need for a new camera, 
then, was somewhat out of 
necessity. However, with several 
years of new developments and 
changing chip prices since the first 
Camera Module, it did mean that 
improvements could be made to 
the original design. 

“The major changes are a new 
sensor module based on a Sony 
IMX219,” James explains. “In testing, 
it performs very well and is a good 
improvement on the Vi camera. It’s 
also an 8 megapixel sensor rather 
than the 5MP of the original. And the 
board now has rounded corners!” 


Looking forward 

Not that the old board was sharp 
at all, but the new round-edged 
design fits the style of more recent 
Raspberry Pi releases, such as the 
Pi Zero and even the Sense HAT. 
With a strong focus on backwards 
compatibility with the Raspberry 
Pi, it’s also worth noting that even 
with a higher-resolution sensor, it 
still works with all versions of the 
Raspberry Pi with a camera input. 
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i , RESOLUTION 


With just pure 
numbers, it’s 
| difficult to 
comprehend 
just how much 
| better the 
photos from 
the new Pi 
Camera are. 
Technically 
they're 60% 
larger, but 
that's tricky 
to visualise, 
so here's a 
little example 
of how much 
more picture 
ee that actually 
io © | equates to. 
; You get a lot 
more bang for 
your buck! 


With this backwards compatibility 
in mind, it’s no surprise to learn the 
software side of it hasn’t changed 
at all, with Gordon informing us 
that raspistill and raspivid still 
work the same as before. This also 
includes the lesser known timelapse 
and raspistillyuv (for RAW photos) 
functions. This means that you can 
replace the camera in your existing 
projects that use it, and the v2 will 
work just the same without needing 
to tweak any of the code. 

The new camera is a lot better, 
then, and the team have done a 
good job making it, although James 
would like to see an addition to 
the hardware on the board if it 
were possible: 

“The only real feature that would 
be nice on a camera is audio (i.e. 

a microphone), but currently we 
have no good technical solution 
for how to do this, as the camera 
connector does not support 

an audio interface.” 

Remember to bring a microphone 
along, then, when recording your 
next great Pi-powered short film. 
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Feature | P| CAMERA V2 


Giese 


STARTED 


magpi.cc/ 


aMYYTMo 
> Raspberry 
Pi Camera 
Module V2 
magpi.cc/ 
1UaFuuW 


You know what’s new with the camera - so how can you go about using it? 


igher pixel counts. Smaller old camera, in fact. However, aswe Menu and go down to Preferences. 


pixel sensors. Rounded haven’t done a very basic ‘set up Here you’ll find the Raspberry 
edges. You’ve seen the your camera’ tutorialin quitesome Pi Configuration menu, which 
specs and stats forthe new Camera __ time, we thought we’d update it for you should now click on. On the 
Module, so how do you go about 2016 and beyond. tab called Interfaces, you’ll find 
using it? Well, remarkably like the an option to enable the camera; 
>STEP-0O1 if this isn’t set to Enabled, do so 
Connecting the camera now. Raspbian doesn’t have the 
Make sure your Pi is switched off camera enabled by default, so this 


before connecting or disconnecting _is required. Now reboot your Pi. 
the camera. Pull out the power 


KCL 0216 


3 cable. Take hold of both ends of >STEP-03 
pdr the plastic slider of the camera First shots 
ah connector on the board, and pullit Point your camera at something 
oN away from the Pi gently but firmly; interesting, then open a terminal 
> it will move up a short distance, and type in the following: 
= opening up the connector. 
,« Insert the ribbon cable, with raspistill -o firstpic. jpg 
E the connector side — the blue side 
ww — facing the HDMI port. Push the You’ll see a red light on the 
plastic slider back down, making Camera Module, followed by the 
sure to put pressure on both sides, image of whatever the camera is 
so that it gently clicks into place. pointing at appearing on the screen 
‘ for a moment. If it’s you, you can 
—— ——--- >STEP-02 use the screen to arrange your best 
AKE GuIZE THE PLASTIC HAS BEEN Camera software smile during the five-second pause 
(ZEMOVED FIZOM THE LENS Ligand Plug the Raspberry Pi back in and before the picture is taken. Once 
You GET STATETEV! turn it on. Once it’s booted into snapped, the image can be found in 
the desktop, click on the Program the home directory — /home/pi. 
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Find the image 

You can open the picture and 
view it from the File Manager, 
but if you don’t have a Pi 2 or 

Pi 3, you may want to avoid 

the unnecessary overhead of 
running that, and just enter this 
into the terminal: 


gpicview firstpic.jpg 


If it looks rather blurry, check 
that you remembered to peel the 
protective plastic from the Camera 
Module’s lens! 


More advanced commands 
The raspistill command has 

a list of options so long that it 
borders on the intimidating. Have 
no fear, though - you won’t need 
to learn them all, but there area 
few that might be useful to you, 
such as: 


raspistill -t 15000 -o 
newpic. jpg 


The -t option changes the 
delay before the picture is 
taken, from the default five 
seconds to whatever time you 
give it in milliseconds — in this 
case, a full twenty-five seconds 
to get your shot arranged 
perfectly after you press ENTER. 
You can find the full list of 
options here: magpi.cc/1SqBfuT 


A quick fix 

One of the problems with a 
camera at the end of a ribbon 
cable is getting it positioned 
properly. You may end up 

with the camera upside down 

or Slightly askew. Upside- 

down Camera Modules can be 
commanded to flip the picture 
the right way up with --vflip, 
or -vf for short. --hflip 
handles horizontal flipping, 
should you need a mirror image. 
And if your camera is lying on 
its side, use --rotation, or 
-rot, followed by the number of 
degrees: 90 or 270. 
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For taking video, raspivid is what 
you need. It can record up to 1080p 
video at 30fps, a fast enough frame 
rate for cinema, and 720p at 60fps 
if you want something smoother. 
You can do this with: 


raspivideo -t 10000 -o 
testvideo.h264 


This records a ten-second video 
(10,000 milliseconds) at the default 
1920 «x 1080 format. You can also 
shoot slow-mo video at 640 « 480 
by using: 


raspivid -w 640 -h 480 
-fps 98 -t 10000 -o 
test9Ofps .h264 


Use omxpLayer in the command 
line to play the videos back! 
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Breadboard 


> Jumper wires 


> A button 
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THE HAYLER-GOODALLS 


Ozzy, Jasper, and Richard are mentors 


~ at CoderDojo Ham and gave a talk 


about their Astro Pi adventures at the 
Raspberry Pi birthday party. 


- @rdhayler / coderdojoham.org 


richardhayler.blogspot.co.uk 


PI CAMERA 


Take wonderful pictures with your Pi Camera at a click of a button, 
perfect for time-lapse photography and stop-motion video. 


ave you been reading the 
last few pages, thinking 
that you’d prefer to 
take a picture with a Raspberry 
Pi without all that typing on the 
command line? In this tutorial we’ll 
show you how to take a picture 
with a click of a button, just like a 
real camera. This could be useful 


There are lots of cases that 
can hold a Raspberry Pi 
and a camera; choose the 
one that suits your needs 


This is an ideal setup for 
stop-motion animation 


for many projects (for example, 
time-lapse photography), but in 
this tutorial we are focusing on 
stop-motion animation. 

Before we start installing the 
camera and wiring the button, you 
need to make sure you’ve installed 
the camera on the Raspberry Pi, 
as shown on the previous page. 


ff 
a r 


If your Raspberry Pi is not already 


switched off, do that now. Then, 
connect the button to the Piviaa 


jumper lead, as shown in Fig 1. One 
side of the button will be connected 


to ground; the other is connected 


to GPIO pin 14 (but you can choose 


your favourite pin). That’s all the 


hardware done; now let’s install all 


Use the button for a quick | 
and easy way to take pictures 


Me os eee ee 
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Install the Pi camera 

Make sure you add the camera to the 
correct socket: there are two on the Pi, 
which look identical. We want the one 
between the HDMI and audio ports. 


the necessary Python modules via 
the command line. Type: 


sudo apt-get install python3-pip 
sudo pip3 install gpiozero 
picamera 


Coding the button 


Finally, we need to think about the 
code we’ll be using. Because we’re 
focusing on stop-motion, we’ve 
used the camera’s preview mode so 
that we can set up our shot before 
we take it, to ensure everything 

is in the frame. Then, only when 
the button is pressed, we save an 
image file. Each image file will have 
a different name based on the date 
and time at which it is taken. This 
makes it easy to assemble all the 
images from the shoot for post- 
processing. The wonderful gpiozero 
library is used to capture the button 


Raspberry Pi Model 2 


© Raspberry Pi 2014 


Fig 1 It's very simple to wire up a button 
to the Raspberry Pi 


Wire up the button 


You can use a breadboard for a small 
button. Alternatively, you can connect 
your jumper wires directly to the pins 


on a bigger one. 


activity; we simply define a function 
that is run whenever the button 
is pressed. This function uses the 
picamera Python library which 
allows us to control the camera 
through code, making all the normal 
command-line operations available. 
Download or type up the code 
from the listing and either run it 
through IDLE or the command line. 
Type CTRL+C to quit the program. 
You should be able to use this code 
as a template to create a program for 
whatever photography project you 
have in mind. For example, you could 
alter the code so that the camera 
takes continuous photos while the 
button is held down. Or you could add 
extra buttons to make a variety of 
photography modes available. 
With this sort of build, you can 
also start thinking about building 
a complete, portable, wirelessly 
connected Pi camera. For this, 
you can even use the Lego case - 
all you’d require is a portable mobile 
phone battery charger, along with 
a screen to attach to the Pi. Witha 
bit of modification of the code, you 
can have it always show the preview 
of the camera on the screen. Want 
to record video? More modification 
of the code will allow for video 
capturing. The only issue you might 
have with both of these projects is 
a flash or light source, so a well-lit 
subject will be essential. 


Lights, camera, action! 

Create your stop-motion scene and 
use the button to trigger the camera 
to take pictures and save them 

to timestamped files. 


>Py 
>Pp 


imple 
Camerap 


HON 3 


magpi.cc/1MFuVNG 


from datetime import datetime 
from gpiozero import Button 
import picamera 

import time 


b=Button( 14) 
pc=picamera.PiCamera() 
running = 


timestamp=datetime.now() 
picture(): 
pc.capture( ‘pic'+str(timestamp)+' .jpg') 


pc.start_preview() #running the 
b.when_pressed=picture 
ERY: 

while running: 

print('Active' )#displaying ‘active’ to 
the shell 
time.sleep(1) 

except 

pc.stop_ preview () 

running = 
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3D YOUR MOVIES 


Technically, our setup can 
be used for making films as 
well. However, the process of 
turning the videos into a 3D 
movie is a bit more complex 
than a 3D photo. If you own 
a copy of Adobe 
Premiere, you can 
find ways to make 
it anaglyph red- 
and-blue 3D, like 
in the photos, but 
you ll need a bit 
more for modern 
movie-style 3D. 


aking 3D video and film 
Soe PirCamern is actually not so tricky 
modules on the hardware side - 
magpie you just need to make sure you 
1VaFuuW . 
have two camera sensors working 
>2xRaspberryPis = simultaneously in the right 
> PC/laptop orientation. The challenging bit is 
Soave aie. combining them and timing them. 
magpli.cc/ - } 
aMms5Npi With the Raspberry Pi, or several of 


them, and the right bit of code, you 
too can take some 3D photos with 
the new camera module. 


A smidge of theory 

If you fiddle with the internet long 
enough, you’ll bump into sockets. 
Sockets are an API that allows one 
computer to talk to another. They 
work much like a telephone: you 
dial up a number (or IP address) 
and wait for the other side to 
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PICTURES 


Use two Raspberry Pis and camera modules to create 3D photos - 
with the help of a bit of software, of course 


answer. This is a one-to-one 
connection, or unicast. 

But we need to talk to many Pis 
at once. This is where broadcast 
comes in. It’s a mechanism 
that allows devices on the same 
network to talk to each other 
without needing a phone book. 


Preparing your Pis 
You’ll need to change the default 
hostname of both your Raspberry 
Pis. Let’s make it simple and use 
the names ‘left’ and ‘right’. 

Power the first Pi on and type 
sudo nano /etc/hostname 
in a terminal window. Replace 
raspberrypi with left. We also need 
to update the hosts file: open it 
with sudo nano /etc/hosts and 
again replace raspberrypi with left. 


WILLEM KOOPMAN 


Peripatetic sysadmin, providing 
grumpy solutions to grumpy problems. 
Stumbled upon the field of computer 
vision while working in the magical 
world of visual effects. 
secretbatcave.co.uk 


e 
— m= = = 


% 
a. 


Our subject, the humble 
Babbage bear, ready for 3D 


The two Pi cameras need ~ 
to be close to each other 


Finally, sudo reboot. You 
should be greeted by: pi@left ~ $ 
when you log in or open a terminal. 
Repeat this process for the other 
Pi, using right. 


Tool installation 

We need to install some tools. 
Power both Pis on, SSH into 

them from your other computer 
(ssh left, password raspberry) 
and then run: 

sudo apt-get install git 
python-picamera screen 

Now, we check out the Python scripts 
on both Pis. We can do it quickly 

via SSH: 

ssh left ‘git clone https:// 
github.com/secretbatcave/ 
pipolypicture' 

This will log into the left Pi and run 
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ale 


listens for a broadcast packet with the string "photo" in it. 
then takes a picture, names it with the hostname and timestamp 


import time 
import socket 
import picamera 


udp = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) 
udp.setsockopt(socket.SOL_ SOCKET, socket.SO REUSEADDR, 
udp.setsockopt(socket.SOL_ SOCKET, socket.SO BROADCAST, 


udp bandit; 8) 
print ‘BEGIN!’ 


with picamera.PiCamera() as camera: 


camera.resolution = (2592,1 


time.sleep(1) 
while 


) 


data, addr = udp.recvfrom(1024) 


print "Got me a packet" 
print data 


ings 


if "photo" in data: 
print "taking a photo" 


serial = data.split('-") 


serial = serial[1] 


camera.capture("{@} {1}.jpg".format( 


socket. gethostname(),serial) ) 


the git clone command. Do the 
same for the right Pi. 


To test that everything is working: 
ssh left 

cd pipolypicture 

sudo python listener.py 

You should see something like: 
pi@left ~ $ sudo python 
listener. py 

BEGIN! 


Listening and sending 

Now that we have all the code and 
libraries installed, let’s start taking 
some photos. You’ll notice there 
are two programs: sender.py 

and listener.py. You need one 
listener.py for each of the devices 
that you want to control. Sender.py 
controls them all with its magic 
broadcast socket. 


Let’s get things set up: 

ssh left 

cd pipolypicture 

screen python listener.py 
Press CTRL+A then CTRL+D to 
disconnect the screen session but, 
crucially, leave listener.py running in 
the background. Press CTRL+tD again 
to disconnect from left. We now need 
to do the same for right. 


Taking photos 

We've primed the Pis to listen 
for a magic word, so let’s start 
taking pictures! From your 
master computer, enter: 


cd pipolypictures 
python sender.py 


You’ll be greeted by this prompt: 
enter to take picture, q to quit: 


PYTHON 2 


magpi.cc/1N9d0z3 
This sends out a broadcast 
packet with the word "photo" 
and an incrementing number 
import sys 
import time 
import socket 


MYPORT = 


S = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) 


s.bind(('', @)) 


s.setsockopt(socket.SOL SOCKET, socket.SO BROADCAST, 


count = 2 
while 
data = "photo-{0}".format (count) 
count = count + 
s.sendto(data, ('<broadcast>', MYPORT) ) 
time.sleep(2) 
message = ( 
"enter to take picture, g to quit:") 
if (message) == ‘q': 
sys.exit() 
print "woo" 


Hitting ENTER sends out a packet 
with the word ‘photo’ to every device 
on the local network. The listener 
programs on each Pi will pick up 
this packet and take a picture. Each 
packet we broadcast has a number 
attached. This number is used as the 
second half of the file name, so we 
can pair up the pictures easily later. 


Combine them into 3D 

With both cameras placed right 
next to each other, you can use 

the resulting images to create a 

3D image. The easiest way is to do 
this online using a website like 
create3dphoto.com; this makes 
old-school red-and-blue anaglyph 
stereoscopic photos, so you may 
need to dig out some old-fashioned 
3D glasses for it. Experiment to see 
how to make the perfect 3D photo. 
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MAKE A 


> Raspberry Pi 
Camera Module 
magpi.cc/ 
1UaFuuW 


PHOTO BOOTH 


DAN ALDRED 


© A Raspberry Pi Certified Educator 


who writes and makes excellent 
Raspberry Pi projects, among 
many other things. 


tecoed.co.uk 


Create a photo booth in Minecraft that takes photos of the real world. 
What will you see on your travels? 


few issues ago we did 

some Minecraft mash-ups, 

going beyond the normal 
Minecraft Python programming to 
have it interact with the real world. 
With this tutorial, we’re bringing 
this concept back by having 
Minecraft activate the Pi camera 
with code. This tutorial can be 
found in the excellent Raspberry Pi 
resources (magpi.cc/1qEg9Nh). 

The first thing you need to 

do is import the Minecraft API 
(application programming 
interface). This enables you to 
connect to Minecraft and use 


® Construct your photo 

| booth however you wish; 
I just make sure the code 
| knows where it lives 

1 


Your shutter in the world 
of Minecraft - move him to 
the booth to take a photo 
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Python to code. You also need 
to import the PiCamera module 
to control the camera, and the 
time module to add a small delay 
between taking each photo. 
Open Minecraft from the 
application menu, then enter an 
existing world or create a new 
one. Move the Minecraft window 
to one side of the screen. You’ll 
need to use the TAB key to take 
your mouse’s focus away from 
the Minecraft window to move 
it. This is needed later when you 
switch between the Minecraft and 
Python windows. 


Place it anywhere in your world. 
Build a house and give ita special | 
room, or use it as a trap to see if 1 | 
someone is playing inyour world © 


Open Python 3 from the 
applications menu. This will open 
up the Python IDLE code editor 
which you’ll use to write the photo 
booth program; click New>Window 
to open a new window. 

Enter the code in the listing 
(or you can download it and open 
it now). Save with CTRL+S and 
run the program with F5. You 
should see the message ‘Find 
the photobooth’ appear in the 
Minecraft world. This is the first 
part of the code. Stop it running 
using CTRL+C and we can explain 
the rest. 


Camera tests 
Next, we’ll make sure the camera 
is set up. We’ve set the camera to 
show a two-second preview, so 
that you can strike your pose and 
smile before the picture is taken. 
The image is stored as a file called 
selfie.jpg in your home directory. 
Now, you need to create a photo 
booth in the Minecraft environment. 
This is done manually, and the 
photo booth can be built wherever 
you want to locate it. Using any 
block type, build your photo booth. 
It can be any shape you like, but 
it should have at least one block 
width of free space inside so that 
the player can enter, like a door 
or gate. 
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Once you have created your photo 


booth, you need to be able to move 
your player inside and onto the 
trigger block. This is the block that 
the player stands on to run the 
function that you wrote in step one, 
which will trigger the camera. In 
the Minecraft environment, your 
position is given in reference to 

the x, y, and z axes. Look at the 
top-right of the window and you’ll 
see the x, y, and z coordinates of 
your player - for example, 10.5, 9.0, 
-44.3. Assuming you’re still in the 
photo booth, then these are also 
the x, y, and z coordinates of the 
‘trigger’ block in your booth. 


Walk into your 

photo booth 

Note down all three coordinates 

of your camera ‘trigger’ block. 
When you’ re playing Minecraft, 
your program will need to verify 
that you’re inside the photo booth. 
If you are, then it will trigger the 
take_the_pic function and take a 
picture with the camera. To do this, 
Minecraft needs to know where you 
are in the world. 

In order to find your position, 
you use the codex, y, X = 
mc.player.getPos(). This saves 
the x, y, and z position of your 
player into the variables x, y, and z. 
You can then use print(x) to print 
the x value, or print(x, y, z) to 
see them all if you wish, by adding 


it to the code. Now you know the 
position of the player, you can test 
to see if they’re in the photo booth. 
At this point we have a photo 


booth, the coordinates of the trigger 


block, and code to control the 
Camera Module and take a picture. 
The next part of the code is to test 
whether the program knows when 
you’re in the photo booth. To do 
this, we create a loop which checks 
if your player’s coordinates match 
the trigger block coordinates. If 
they do, then you’re standing in 
the photo booth. For this, we use a 
simple if statement, which we call 
a conditional. 

Change the if line in the code 
to ensure the coordinates you enter 
are those of your photo booth. 

Save and run your code to test it: 
walk into your photo booth and 
you should see the message ‘You 
are in the photobooth!’ in the 
Minecraft window. 

You will note that the if 
statement checks if the x value is 
greater than or equal to 10.5: this is 
to ensure that it picks up the block, 
as it could have a value of 10.6. 
Remember to replace the x, y, and z 
values with those from your photo 
booth. After the message is printed, 
the same preview and camera snap 
will happen as before the while 
loop, then the loop resets itself 
So you can enter it again and take 
another photo! 


Left Take selfies 
with the help of 
Minecraft Steve. 
If only he could join 
you in the photo 
as well... 
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MinecraftBooth 


photobocth.py 


from mcpi.minecraft import Minecraft 
from picamera import PiCamera 
from time import sleep 


mc = Minecraft.create() 
camera = PiCamera() 


mc.postToChat("Find the photo booth") 


camera.start_preview() 

sleep(2) 
camera.capture('/home/pi/selfie. jpg’ ) 
camera.stop_preview() 


while 
X, Y, Z = mc.player.getPos() 


sleep(3) 


If X >= and y == and Z == - 5 
mc.postToChat("You're in the photo booth!") 
sleep(1) 
mc.postToChat("Smile!") 

sleep(1) 
camera.start_preview() 
sleep(2) 
camera.capture('/home/pi/selfie. jpg’ ) 
camera.stop_preview() 


sleep(3) X 
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MAKE YOURSELF 
SNAP HAPPY 


-THE PI HUT 


SibiS SS ae = Ss) =e = 
NEW CAMERA FIRST 


There’s much more than just savings on 
offer for print subscribers of the magazine. 
Here’s how subscribers got their camera... 


WITH 


On the 25 April we sent all 
print subscribers a special 
code via email, for use at 
ThePiHut.com. The code 
enabled them to buy the new 
Camera Module and receive 
it before everyone else. If 
you didn't get a code or arent 
yet a subscriber, you've got 
until 13 May to subscribe 
and get your code. 
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Use your subscriber 


Cer 
NAPS, 
code at The Pi Hut to: G7 


@® Jump to the front 


of the queue HOW TO USE 
® Get priority handling YOUR @) Bb) = 


of your camera order 
© FIND YOUR EMAIL FROM THE MAGPI 
® Be first in line The email was sent to all 
if it’s out of stock subscribers on 25 April from 


magpi@raspberrypl.org 


@® GRAB YOUR SUBSCRIBER CODE 


If you're an existing subscriber and 


you didn't receive an email, it might Make a note of your unique code 
be because your address isn't in the : : 
subscriptions database. To rectify this, Or COPY it from the email 


simply email magpi@selectps.com 
with your full name and postcode, and 


our subscriptions team will reply with @ VIS IT TH EPI HUT.COM 


your unique code within 24 hours. oe ° 
Not a subscriber? It's not too late Visit thepthut. com 
to use this offer. Simply subscribe and put a Camera Module in your basket 


(over the page) and email magpi@ 
selectps.com requesting your unique 


oe aa aie = ie @® ENTER YOUR UNIQUE SUBSCRIBER CODE 
| Simply input your code at the checkout 
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Subscribe to the Official Raspberry Pi mag today for a whole host of benefits 


Subscription benefits 
Save up to 25% on the price 
Free delivery to your door 
Subscriber-only offers 
Get it first (before stores) 


PI ZERO 
#40 IS STILL 
ON OFFER 


SAVE 
UP TO 


29% 
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A standard Canon EOS 
camera lens fits onto 
one end of the adapter 


Quick 


» This particular 
adapter only 
works with 
Canon lenses 


» It was 3D 
printed at 
Dimension 
Alley in Berlin 


» You need to 
move the lens 
to keep the 
moon in frame 


» James is 
hoping to use a 
longer lens for 
better photos 


hooting the moon has 

been an obsession of 

James Mitchell’s fora 
very long time. After several failed 
attempts to get a clear photo from 
various cameras and lenses over 


» He's also shot 
a time-lapse 
video with 
the adapter 


The pink tinge 
is caused by 

a reflection 

of light on 

the camera 
sensor, which 
James has 
since fixed 
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PI MOON 


With the aid of a 3D printed lens adapter, it’s possible to take detailed 
photos of the moon using the Raspberry Pi Camera Module! 


the years, he decided “on a bit 
of a whim” to give it a go with 
a Raspberry Pi Camera Module 
(magpi.cc/1Nd44Dx). 

“T have been working on pushing 
the limits of the Pi camera for a 
while,” James tells us. One of his 
first pictures was a long exposure 
of a Lego figure, which won him 
the runner-up prize in an Adafruit 
competition. “I wanted to use my 
lenses to improve on that.” 

After discovering a design for 
a Canon lens adapter for the Pi 
by Charmlee (magpi.cc/1MhDNJl1), 
James got a3D print made at his 
local Berlin printing cafe and was 
impressed: “Everything simply 
slots together. Actually quite a 


The 3D printed lens 
adapter comprises three 
parts which slot together 


The Pi camera sensor 
gathers light from a small 
field of view in great detail 


nice design, to be honest, but it 
only works with Canon EF (EOS) 
lenses.” He soon realised that using 
the adapter with the Pi Camera 
Module requires the removal of the 
latter’s tiny stock lens. “It really is 
simple... it just screws off. What 
might be considered difficult is that 
it has a little glue inside to stop it 
from moving. So I used a couple of 
pairs of pliers to remove it.” While 
this did buff the plastic slightly, the 
lens can go back on to protect the 
sensor when storing the camera. 
The Pi camera sensor can then be 
inserted into the 3D printed adapter, 
enabling it to be exposed directly to 
light coming through the attached 
Canon lens. Since the sensor only 
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The final image, post-Photoshop. The pink tinge on the original unedited 
image (bottom-left) was caused by a layer on the Pi camera sensor 


All the components James used for the project, including the red 3D printed 
lens adapter in three parts, which he later wrapped in duct tape 


captures a small section of what 
the lens can see, it does so with 5 
megapixels’ worth of detail. This led 
James to try shooting a full moon 
from his Berlin balcony, using a 
78-300mm lens, which resulted in 
a Surprisingly detailed image of the 
cratered lunar surface. 

Asked what camera settings 
he used, James replies, “I’m 
embarrassed to say I left it on auto. 
In fact, the command I used had no 
modifiers at all- raspistill -o 
moon. jpg. What I got really was a 
happy accident. Could I improve 
the picture with changing some 
settings? Absolutely!... I think I need 
to learn more about how the optics 
work. Maybe I could adjust the 
distance between the lens and the 
sensor to improve the sharpness.” 
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James admits that a DSLR would 
be better for taking a picture 
like this, “but only with a longer 
lens, something larger than 
300mm, or even a telescope.” 

One peculiarity in his moon photo 
is the pink vignette around its 
edges, caused by light reflecting 
on a layer of the Pi camera sensor. 
He has since managed to reduce 
the effect by wrapping the camera 
adapter in black duct tape. 

As well as being useful for 
astronomy images, James’s setup is 
ideal for any type of photo or video 
requiring a high level of zoomed- 
in detail. “You could use [it] to 
monitor birds’ nests that might be 
quite a distance away [or for] macro 
photography with an assortment 
of lenses and adapters.” 
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MARS 


If you’re going to build a robot, why 
not aim for the stars and build your 
own Mars Curiosity Rover? 


» The total 
cost of parts 
was £120 


» The total 
cost of Mars 
Curiosity was 
$2.5 billion 


» The project 
uses three 
separate 
batteries 


» The only 
sensors it’s 
missing are 
wind and 
pressure 


» Mars is the only 
known planet 
inhabited solely 
by robots 


The 

breadboard 
enables all the 
sensors and 
components to be 
quickly attached to 
the prototype 
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ASA’s Curiosity is one of 
the most famous robots 
on... well it’s technically on 
Mars, but it’s more famous here on 
Earth. We think this Curiosity-based 
build is out of this world. 
Marcio Rovai used Curiosity as 
inspiration for his final project 
for Coursera’s ‘Create Your Own 
Internet of Things (IoT) Device’ 
(magpi.cc/25ZpvUa). His Mars 
Rover - or ‘Mobile Station for 
Environmental Data Capture’, 
to use its official name - uses a 
Raspberry Pi to form the brains 
of an environmental data 
capture robot. 
“Tt’s a mobile station prototype 
responsible for environmental data 
capture, [such] as temperature, 


The breadboard 
houses a Bluetooth 
slave chip (for remote 
connection) and the 
HC-11 temperature 
and humidity sensor 


The Raspberry Pi 
collects data from 
the sensors and 
sends it over the 
internet, while the 
Arduino Nano takes 
control of the wheels 
and ultrasound 


humidity, and luminosity,” 

says Marcio. “The idea is to help 
students and hobbyists learn how a 
robot could be remotely controlled, 
and information captured and 
displayed over the internet.” 


The Pi Camera and 
ultrasound sensor are 
mounted on top of 

a 180-degree servo, 
enabling both to be 
remotely rotated 


“The Rover was based on the 
Curiosity,” he tells us. “Both 
were developed for image and 
environment data collection.” 
There are, of course, some physical 
differences (beyond one being 
slung to another planet). “The real 
Curiosity has six wheels that makes 
[it] all-terrain; my Mars Rover is a 
simple differential wheeled robot 
with two motors.” Curiosity also 
has an articulated arm and drill for 
sample collection, which is missing 
on the Raspberry Pi Mars Rover. “But 
the basics are there,” says Marcio. 

Mars Rover uses botha 
Raspberry Pi and Arduino. 
“The Pi is responsible for more 
complex tasks, such as web 
communication, sensor data 
capture, and live video streaming 
— leaving the core stuff like 
mobility, obstacle avoidance, and 
remote control with the Arduino.” 
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“Controlling servo motors using 
PWM outputs directly from RPi 
GPIO isn’t easy,” he explains, “and 
it’s best to have a HAT for that. So 
I decided to leave this job for my 


little friend, the Arduino Nano.” The 


Nano’s main tasks are to receive 
commands, control the servo 
motors, and monitor the ultrasound 
sensor for obstacle avoidance. 


The Mars Rover 1s controlled 
from an Android phone, which 
also provides a video stream 


“Curiosity has a more advanced 
REMS (Rover Environmental 
Monitoring Station) system that 
incorporates the following sensors: 
atmospheric pressure, relative 
humidity, temperature (ground 
and air), ultraviolet radiation, 
and wind currents. So I included 
sensors for temperature, humidity, 
and luminosity (as a simulation 
of ultraviolet). My Rover doesn’t 
capture wind and pressure data 
[like] the real Curiosity.” 

The Raspberry Pi Mars Rover is 


>STEP-02 


(appinventor.mit.edu) to create 
the app. 

“The Rover isn’t fully 
autonomous,” admits Marcio, 
“as you must give [it] directions 
using the remote control. But I 
incorporated automatic obstacle 
avoidance capability, which will 
prevent a ‘bad pilot’ [from crashing 
it] on arock, for example.” 


Data captured by the Mars Rover 
is sent from the Raspberry Pi to 
ThingSpeak (thingspeak.com), 
which turns it into visualisation. 
“One of the great advantages 
of IoT,” says Marcio, “is the 
large range of public websites 
to record, analyse, and visualise 
captured data.” 

Marcio thinks it would be great 
to make it even more like NASA’s 
Curiosity, including adding a robotic 
arm to do mechanical work and a 
more robust body. Solar panels are 


MARS ROVER 
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Projects 


controlled from an Android phone, 
which also provides a video stream. 
Marcio used MIT AppInventor 


on the cards, too, although Curiosity 
is nuclear- powered; perhaps a step 


Above The finished robot looks ready for lift-off 
too far for realism. 


(or at least ready to explore the back garden) 
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Hidden from the eyes of the public isa 
strip of LEDs that simulate daytime for 
the residents of the model railway 


» The town is 


refurbished in 
the winter while 
it's closed 


» Terryisa 


veteran coder 


» The model 


railway itself is 
full of Thomas 
the Tank 

Engine figures 


» More upgrades 


can be added 
in future 


» Parts of the 
track are 
interactive 
for visitors 
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Acomplete model 
railway, much smaller 
than the Model Town 
outside the door. 
Human for scale 


A Pi Zero controls the lights 
throughout the railway, 
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MODEL 
RAILWAY 


A model town in Wimborne has a separate model railway attraction. When it 
came time to upgrade parts of it, a Raspberry Pi was the natural choice 


n the beautiful town of 

Wimborne, very close 

to where The MagPi is 
made, is a Superb model town that 
has existed for almost 70 years. 
It’s a lovely tourist spot anda 
wonderful attraction, of a type 
that’s fairly rare these days. As 
part of the model town, there’s 
also a great little model railway. 
During the off season just past, 
the lights that make up part of this 
miniature railway were upgraded 


using a Raspberry Pi, by a team 
lediny Temp oles ameneineenns 
manager who helps out at 
Wimborne Model Town. 

“The fundamental requirement 
for the lighting is simple,” Terry 
tells us. “Simulate daylight, dim 
the lighting to simulate night- 
time, and then bring on lights in 
the trackside houses and streets. 
However, these were not the 
difficult goals; a bit more work was 
necessary because the finished 


system needed to be reliable, 
easy to use and maintain, and 
capable of being upgraded readily 
in the future.” 

After a lot of discussion, the 
team settled on a Raspberry Pi 
Zero for the task: “This allowed 
for future upgrades and was 
considered more accessible to the 
average volunteer than, say, using 
an Arduino.” 

The system isn’t just made up 
of a Raspberry Pi, though: there’s 
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The model town has been around since 
the 1950s, and offers an accurate view rte} 
of the town from that era 2 \* 3" iy 


~ 


>STEP-01 


Although Thomas the Tank 
Engine-themed, there are 
some other pop-culture 
cameos on the railway 


much more to it. The lights being the aforementioned WiringPi2. 
used weren’t just afew LEDs stuck — The final code was then moved 
to a breadboard, as Terry explains: over to a piCore image for actual 


“The WiringPi2 library was deployment. Terry says that as 
| a | >STEP-02 
used to allow programming of a the volunteers will just turn the Pi 
pulse width modulation (PWM) on/off rather than do a software 


signal. This dims and brightens a shutdown - it’s a bit tricky with 
48W LED strip on GPIO pin 18 (the the way the system is built - piCore 
hardware PWM pin) to simulate the was the obvious choice, as the OS is 
‘Day’ lights. A MOSFET driver was loaded into memory and so there’s 


Reliable, easy to use and 
maintain, and capable of being 
upgraded readily in the future 


used to carry the current needed. no reading or writing going on a. (i fiulll | 
The lighting in the houses and from/to the SD card. z - ee geen 


elsewhere was switched by four All the software written for = pam d | x 


other GPIO pins viaarelay board.” — the project is also open-source, 
The system itself was developed = with Terry maintaining very 


on a Raspberry Pi with Raspbian, thorough documentation and >STE P-03 
to make sure it was all working. sources that you can find here: 

Originally written in Python magpi.cc/1Nl7nhg. If you ever 

with the RPi.GPIO library, it find yourself on the south coast in 

doesn’t quite support hardware or near Dorset, go give the model 

PWM so was then changed to town and railway a look! 
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» The wheel's 
radius is 
0.6m; the 
circumference 
is 3.77M 


» The height, 
including the 
frame, is 1.35mM 


» The current 
speed record Is 
12.5km/h, set 
by Jasper 


» The wheel has 
been in use 
for almosta 
year now 


» Jasper and 
Ruben have 
travelled 42 
kilometres 
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Car felt is used to cover 
the wheel, so the cats are 
comfortable running on it 


This disc (actually a CD) 
covers the nails and 
sensor used to detect the 
speed of circular motion 


The wheel is held upright 
using a custom-built 
steel frame 


Get your moggies moving with this giant hamster wheel for cats 
that monitors feline exercise 


e love furballs here at 
The MagP1, and this giant 
hamster-style wheel 

for exercising cats is a strong 

contender for our ‘pet project 

of the year’ award. 

Jasper and Ruben are two cool 
cats, with an even cooler owner (who 
doesn’t want to be named). “[It’s] 
the same as a hamster wheel,” says 
Jasper’s owner. “They can run and 
walk on it whenever they please.” 
The proportions are a bit different: 


whereas most hamsters wheels 

are roughly twice the height of a 
hamster, this cat wheel is about 
three times a cat’s height. 

“The Raspberry Pi gets triggers 
from an electromagnetic sensor 
attached to the frame,” he tells 
us. There are “six small nails 
under the lining on the back of the 
wheel, serving as actuators. Based 
on these triggers, activity on the 
wheel can be detected, and the 
speed is calculated.” 


The Raspberry Pi monitors the 
sensor using a GPIO port and on 
every trigger, the current speed 
is calculated. Jasper and Ruben 
were lured onto the wheel using 
cat treats. “We first let them get 
used to the wheel’s movement, as 
standing on it causes it to swing. 
Then we just held the treats a 
little higher so they’d have to start 
walking to get near them. We’d 
reward them when walking by 
actually giving them the cat treat 
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and some additional attention, 
which is what it’s all about 
for them.” 

Both cats are now used to the 
wheel, and they’ve been using it 
for along time. “They both do,” 
says Jasper’s owner, “at least 
twice a day, any time, night or 
day. Preferably when somebody is 
admiring them. 

“They walk on it at about 3km/h 
and travel distances of over 250 
metres,” he continues, “often 
taking several short breaks, which 
are mostly caused by distraction. 
Sometimes they take a sprint, 
usually peaking at 8km/h. Overall, 
they perform equally — if there’s 
a speed difference, it’s too small 
to notice.” 

The build itself is also impressive. 
“The rear disc is a plywood plank, 


CATWHEEL 


11:42:40 2 
avg:2.9 max:4.6 10./m 15.5s 46.5c 


He tells us it was a relatively easy 
project. “The only problem was 
moving it because it’s large, bulky, 
and quite heavy. Having all the 
materials and necessary equipment 


The Raspberry Pi gets triggers 
from an electromagnetic sensor 


the cylinder is galvanised steel, 
and the surface of the entire 
wheel is covered in car lining. The 
entire frame is made of stainless 
steel, offering stability and 
necessary counterweight. 


in one place would have saved 
us a lot of time. 

“Td also like to be able to 
determine which cat is on the 
wheel,” he adds, “maybe by 
analysing the colours in the picture. 


CATS ON WHEELS 
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That way I'll be able to keep 
separate Statistics.” 

If you’re thinking of making a 
Catwheel, Jasper’s owner has some 
good advice: “Make it as big as 
possible, so that the cats can walk 
comfortably. Use a central bearing 
system and high-quality bearings, 
so the wheel runs smoothly and 
quietly. Cats don’t like noise, soa 
noisy wheel won’t be very tempting 
to them. When it’s finished and 
ready to use, be patient. Forcing a 
cat to do something will never work. 


Every cat is different, and it may just 
not be interested at all. It’s arisk you 


should be willing to take.” 
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Projects 


Above A camera 
records the cat 
walking on the 
Catwheel and 
transmits the 
image, along 
with motion data 
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ESSENTIALS 
LEARN | CODE | MAKE 


AVAILABLE NOW: | 


> CONQUER THE COMMAND LINE 
> EXPERIMENT WITH SENSE HAT 
> MAKE GAMES WITH PYTHON 
> CODE MUSIC WITH SONIC PI 


ESSENTIALS Ma GPi i822: mags 


The 


Milf Pervemsescie From the makers of the 
official Raspberry P1 magazine 


OUT NOW IN PRINT 


ONLY £3.99 


from 


raspberrypl.org/magpl 


GET THEM 
DIGITALLY: 


The Raspberry Pi needs to be connected 
to the internet to access web services 


The number of LEDs lighting up will | 
increase with the temperature 


STEP BY STEP 
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Below You need to copy the API key in order 
to use the OpenWeatherMap service 


My Home 
setup 
Usemame ioana 
Email loana_ 
Full name 
Save 
API key Petcsd68 1bedal2as6Ga04dae saan? be 


Pi- THERMOMETER 


Connect your Pi to existing web platforms and easily build 
your own internet-based thermometer out of LEDs 


Wyliodrin STUDIO 
goo.gl/Sgj9gHB 


3x Green LEDs 


5x Yellow LEDs 


2x Red LEDs 


10x 220-ohm 
resistors 


Breadboard and 


jumper wires 
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ow often do you check your browser or 
smartphone to see how cold it is outside? 
Nowadays, we read the temperature using 
applications that take data from the internet and 
display them in a nice interface. This reduces 

the interactivity and simplicity that old mercury 
thermometers had, while offering the great flexibility 
of reading the temperature anywhere on the globe. 
But what if you could have the best of both worlds? 
You can put your Raspberry Pi to use and replace the 
computer with a thermometer-like device, which 
has the capability of displaying the temperature at 
whichever location you wish. 


>STEP-0O1 


Set up the Raspberry Pi 

Wyliodrin STUDIO is an IDE (integrated development 
environment) that makes it very easy to create 
complex applications for your Pi. First of all, you 
need to download it (goo.gl/Sgj9HB) and follow the 
first two steps of the Getting Started tutorial for the 


Raspberry Pi. Once you have an SD card with the extra 
service installed, you need to connect the Pi to the 
internet, in the same network as your computer. As 
soon as the board has booted, you will see it available 
under Port. Press Connect and you’ re ready to go. 


>STEP-02 

Create a new visual application 

In order to create the thermometer, press the 
‘projects’ button and create a new application. 

Name it ‘pi-thermometer’ and select ‘visual’ for 

the programming language. Open the newly created 
app and you’ll see the frame in which you need to 
connect the visual elements. The blocks gallery is on 
the left. We have chosen this way of programming 
because it allows you to rapidly create the code, and it 
doesn’t require you to know any specific programming 
language. In addition, if you’re familiar with Python, 
you can press the ‘Show code’ button and see how 
the code gets generated as you drag and drop the 
visual elements. 
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Build the thermometer 

From the hardware point of view, you simply need to 
connect ten LEDs to the GPIO pins of the Pi. You can 
visualise the number assigned to each pin by selecting 
the ‘Pin layout’ tab in Wyliodrin STUDIO. We have 
chosen to connect the LEDs on pins 0 to 9. We will 
scale the read temperature and light up a variable 
number of LEDs accordingly. 


Weather API 

The website openweathermap.org offers a complex 
API that allows you to get weather details from cities 
around the world. To access the API, you need to sign 
up for a key at openweathermap.org/appid. You only 
need to provide your email and choose a password. 
Once you have created an account, you can use the API 
key available at home.openweathermap.org. 


Writing the application 

The application reads the weather from the city of your 
choice and maps the value to the number of LEDs. The 
string used within the ‘Init weather API’ block is the 
key you got in the previous step. 

In order to do the mapping, we specified the average 
minimum and maximum temperature values according 
to the current time of the year. It’s recommended that 
you use a reduced range, to make the differences in 
temperature visible on the thermometer. 


Tutorial 
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If you would like to see the Python code that will 
get executed once you run the project, you can select 
‘Show code’. 


Check the thermometer 

All that’s left to do is to run the application. As long as 
you don’t stop it, the device will read the temperature 
from the internet every 30 minutes and update 
accordingly. You could add more LEDs to make it 
suitable for a larger range of temperature values. We 
suggest you also put the device in a box so that it looks 
just like a thermometer. Now you’1l know how warm it 
is outside with just a turn of your head. 
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The 
thermometer 
displaying a 
temperature 
of 15° Celsius 


see 
renee 
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Raspbian 
raspberrypi.org 
/downloads 
- though most 
of the tutorial 
series will 
work with the 
command line 
running the 
Linux default 
Bash shell 

on any GNU/ 
Linux PC 


IPV6 


Despite the 
world of 
connected 
devices crying 
out for the 
billions of 
addresses 

of IPv6, IPv4 
remains the 
norm. Adding 
IPv6 to the Pi 
simply involves 
putting ipv6 on 
a line by itself 
at the end of 


/Zetc/modules. 
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GB p@raspbenypi ~ 


GNU nano 2.2.6 Fille: .../network/interfaces 


/etc/network/interfaces contains an 


entry telling the Pi to use DHCP to allocate 
an address. Change it to static, and give 
your board a permanent address 


ifconfig gives you your internet address; 
unless your Pi is sitting in a data centre, 
this is likely to be a private address such 
as one in the range beginning 192.168.0.0 


PREDICTABLE 
NETWORKING 


Give your Raspberry Pi a permanent network address of its own... 


hey say that the network is the computer: 
something becoming more vital as connected 
devices integrate more and more real- 

world interactivity with data and processing across 
the internet. Raspbian takes care of automatically 
connecting in most situations, but sometimes you 
need to override automatic configurations, to ensure 
a consistent network setting for your Pi project: 
Raspbian has the tools, and we’1l show you the 
essentials you need to stay connected. 

Plug a network cable from your ADSL router to 
your Pi and, automagically, Raspbian knows where it 
is on the network, and can talk to the outside world. 
How? Because it’s setting itself up the way your 
router tells it to. This is thanks to DHCP - Dynamic 
Host Configuration Protocol - which provides 
network configuration for every device connected 
into a network. 

Check you’re using it by issuing the command: 
cat /etc/network/interfaces. This should show, 
amongst others, a line like iface eth® inet dhcp, 
which means you’re set up to receive configuration via 
DHCP. The etho is the name of your Ethernet port into 
which you plug your network cable; a wlano here is for 
any WiFi adaptor you may connect to your board. 

For many projects on your Pi —- whether something 
cutting edge with sensors, or something as useful but 
mundane as a VPN to protect your mobile browsing 
from intrusive location-based advertising — you’ ll 
need an internet address that doesn’t change, so that 


whatever remotely connects to you can always find 
you. We’re using local addresses here, although it is 
possible to remotely access a Pi behind a router. 


Static address 

Network settings are found in /etc/network/ 
interfaces; before changing them, make a backup 
copy of your current working setup with: 


sudo cp /etc/network/interfaces /etc/ 
network/interfaces.bak 


Open /etc/network/interfaces with your favourite 
editor (or nano) and change iface etho inet dhcp to 
iface etho inet static (and the later mention of dhcp, 
under default, if you have it in your config file). Then 
add the following information below it — or rather, 

a version appropriate for your network: 


address 192.168.0.207 
netmask 255.255.255.0 
gateway 192.0.0.1 


Here, ‘address’ is either the IP (version 4) address 
already allocated by DHCP to your Pi, or one with the 
last of the four numbers (together they’re known as 
a dotted quad) changed to a higher number, which is 
unlikely to be allocated by your router’s DHCP server. 
You can usually configure your router’s range of 
addresses allocated, or reserve particular addresses. 
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The gateway address is the address of the device 
sitting between you and the internet: your ADSL 
router. You can discover this with sudo route -n 
where the -n is requesting the numeric address, 
rather than the name of the gateway. The address the 
Pi is currently using is shown with sudo ifconfig, 
as is netmask, which is listed as Mask. 

If you look at example /etc/network/interfaces 
files online, or from other people’s projects, you may 
also see entries for network and broadcast, showing 
the first three numbers of the dotted quad address 
of the device, followed by ao and a 255, respectively. 
These tell your computer a little more about the 
network that it is on, but aren’t strictly necessary to 
getting things working. After editing the network 
configuration you need to restart the service: 


sudo ifdown eth@ && sudo ifup ethde 


Check that all is now well, both with ifconfig and 
trying a ping from another computer on the network. 


Ping! 

Ping is the most basic tool in the network testing 
armoury, but one which is often called upon. It 
sends ICMP (the Internet Control Message Protocol) 
ECHO_REQUEST to a device on the network. ICMP 
is built into every connected device and used for 
diagnostics and error messages: a ping will produce a 
reply from the pinged machine, which tells you it is 
on, and connected, and that the network is working 
between you and it. Information about packets lost, 
and time taken, also helps with fault diagnosis. 

A successful ping localhost from the Pi tells you not 
just that the local loopback interface is working, but 
that localhost resolves to 127.0.0.1, the local loopback 
address. Name resolution is the cause of many 
computing problems, so we’ll come back to that further 
down the page. 

Now ping the Pi from another machine on your local 
network: ping 192.168.@.2@7 — you’ll need to use 
the static I[Pv4 address that you set, rather than ours, of 
course. If you’re doing this from a Windows machine, 
ping defaults to five attempts; from another Unix 
machine (another Pi, a Mac, or Ubuntu or other GNU/ 
Linux), it will carry on until you stop it with CTRL+C, 
unless you set a number of ECHO_REQUEST sends 
with -c like so: ping -c 5 raspberrypi.org 


What's in ag name? 
Numeric addresses are how connected devices 
see the internet, but humans prefer to remember 
names, so DNS - the Domain Name System — exists 
to translate (resolve) addresses like raspberrypi.org 
into something your PC can find on the internet, such 
aS 93.93.130.214. 

The file /etc/hosts contains mappings of host 
(computer) names to IP addresses for local network 
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computers without publicly registered addresses; 
typically, it will only have localhost mapping to 
127.0.0.1, unless you add further addresses. For 
the rest of the internet, a DNS server is queried: if the 
address of your ADSL router is listed in 
/etc/resolv.conf, then your router is getting DNS 
details from your ISP and passing them on with DHCP, 
having told the Pi to ask the router. 

Without DHCP to tell the Pi this, it’s a good idea 
to add an entry for DNS servers to /etc/network/ 
interfaces below the information we added earlier: 


dns-nameservers 8.8.8.8 8.8.4.4 


Here we’ve added Google’s public DNS servers, 
which work reliably from anywhere. Other public DNS 
servers are available, some of which may guarantee 
not to log your IP address when you use them, or get 
your ISP’s DNS server addresses from their FAQ or 
help website. 


MyPiName 

The line 127.0.1.1 raspberrypi found in /etc/hosts 

is there for compatibility with some software which 
expects the hostname to resolve. If you changed to a 


Static IP address, then you can change 127.0.1.1 to that 


new Static address, too. 

Should you wish to have your Pi change its name, 
then change the raspberrypi side of this entry too, as 
well as changing from raspberrypi in /etc/hostname. 
After this change of identity, a system restart 
would be a good idea. sudo reboot is essentially a 
pseudonym for sudo shutdown -r Q, which will 
securely reboot your system from the command line. 
Replacing the -r with an —h will just shut the Pi down, 
as will sudo halt. However, sudo /etc/init.d/ 
hostname. sh will tell Raspbian’s Linux kernel about 
the new name without the need to reboot the Pi. 

Lastly, to add a .local domain to your devices 
on the local network, use apt-get to install 
avahi-daemon for mDNS ( multicast Domain Name 
Servicing), using Apple’s Bonjour, which works on 
most platforms. You should now be able to connect to 
<yournewPiname>.local from other Bonjour-enabled 
computers on your network without even needing to 
use the static IP address you allocated. 


May 2016 MdgPi 


Tutorial 


Left The 
humble ping 

is a useful 
diagnostic tool, 
telling you if 

a connection 

is working, 

a device is 
connected, and 
DNS is resolving 


COMMAND 
LINE WIFI 


If you add 

WiFi to your 

Pi, Raspbian is 
ready, but the 
Wicd Wireless 
Network 
Connection 
Manager also 
has command- 
line clients 

for both 
interactive and 
scripting use: 
apt-cache 
search wicd 


FREE / 
PUBLIC DNS 


As well as 
dynamic DNS 
providers, 
some of those 
found listed at 
FreeDNS.com 
offer public 
DNS servers. 
For a wider 
listing of 
alternatives to 
Google's DNS 
servers, have 
a search on 
Google itself. 
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in this version, but there's no 
collision detection yet 


cS 


You can shoot up the asteroids 


JON SILVERA 


CEO and founder of FUZE 
Technologies, Jon Silvera is keen 
to help kids learn how to code. 
fuze.co.uk 


Create your own version 
of arcade classic 
Asteroids in FUZE Basic 


i 


MAKE AN 
IN FUZE BASIC 


Learn how to start making a full game in FUZE BASIC in part one of this 
Asteroids tutorial by the founder of FUZE himself, Jon Silvera 


> Raspberry Pi 
with updated 
Raspbian 


> FUZE BASIC 
magpi.cc/ 
aSbgYsY 


NO ASSETS 
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steroids is an arcade classic, one of the first really 


popular video games that has endured to this 

day. It’s avery common game to make to show 
off the capabilities of a programming language, and 
FUZE BASIC is no different. 

In the first part of this tutorial, we’ll show you how 
to start making your own Asteroids clone in FUZE BASIC 
for Raspberry Pi, with a ship that moves and fires as you 
want it to. 

The first thing you’ ll need to do is download 
the code so we can work through and explain how 
it works: magpti.cc/1Sbhd7m. 

If you haven’t already done so, download and install 
FUZE BASIC on your Raspberry Pi. Visit 
magpi.cc/1iSbgYsyY for the files and instructions. 

Next, start FUZE BASIC and either load (with F8) 
4573R01D5part1.fuze, or copy and paste the code 
straight into the editor - F2 switches between the editor 
and immediate mode. 

Run the program by pressing F3 or typing RUN in 
immediate mode. This way, we can see how the end 
product looks before examining the code. 


Create a title screen 
to make sure you only 
start playing when 
you want to 


Control the player ship using the Z and X keys to 
rotate, the RETURN key to fire and the RIGHT SHIFT key 
to apply thrust. At this early stage, there’s no collision, 
enemy ships, scoring or sound. 

Press ESC to stop the program, then F2 to bring 
up the editor. Follow along with the code to get an 
understanding of how it works. 


Behind the scenes 
After a few setup procedures, we have a nice and tidy 
LOOP at the beginning, a REPEAT, and then an END. It 
would be great if that was it, but there’s much more! 
The first PROC is playerControls. Procedures are 
a bit like objects or classes, but they are embedded in the 
main program. Here, we check for key presses; if they 
are pressed we rotate, apply thrust, and fire bullets. 
There’s a little bit of maths to explain in the thrusting 
section. If you’re new to COS and SIN, then you have 
some work to do, but basically these allow you to 
calculate a position around the circumference of a circle. 
In this case, we add the COS and SIN to newpX and newpY 
using the current angle the player is facing. 
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After this, we need to apply some damping to the 
movement, otherwise it will continue moving forever. 
This is, of course, correct in ‘real space’, but it makes 
for a bad game control mechanism! 

Now, we add the new calculated offsets to every point 
used in the player ship — if rotating, this must be applied 
too. It looks complex, but we just work out the new x and 
y position for each point in the playerData array. 

The fire button routine makes sure we have only five 
(maxPlayerBullets) bullets in use at once, and uses 
TRUE or FALSE to block the player from just holding the 
button down. 


Tutorial 


DOWNLOAD: 


The code 
takes your ship's 
orientation into 
account using 
trigonometry, so 
that bullets can 
be fired in the 
correct direction 


rock dumped on top of us before we even get a chance. 
PROC resetPlayer sets up the player variables at the 
start of a new level, so they always start in the middle, 
are not firing, and are facing in the right direction. 
PROC rocks checks to make sure a rock is active, 
calculates its position, checks if it’s off screen, and then 
draws them. Some of this won’t make sense right now 
as we can’t collide with them, but next month we’1l have 
different sizes and types to work out. 

The drawPlayer PROC simply plots lines between 
all the coordinates in the playerData array. The next 
routine, PROC drawScreen, displays the score and the 


Procedures are a bit like objects or classes, 
but they are embedded in the main program 


Next, we check to see if the player has gone off 
the edge of the screen and if so, wrap it round 
to the other side. 


Rest of the stage 

The resetRocks PROC sets up the rocks for each new 
level. The number of rocks starts at five and increases 
by one per level. No more than 15 rocks are allowed. 
rDirX and rDirY determine the speed, and rAngle the 
direction. The speed increases with each level. 

PROC initialisePlayer is particularly useful, as it 
allows the rocks to move around without showing them. 
It calculates a safe area around the player ship, so that 
we always Start with time to act and not with a random 
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number of lives remaining, using a line plot routine to 
display the text in vectors. 

Next are some routines to set up new bullets and draw 
them. Again, there is a section to check to see if we need 
to wrap them around the screen. 

The setup PROC prepares everything, sets system 
variables like the screen resolution, and contains the 
data for drawing the four different-shaped rocks and 
the player ship. 

The function DEF FN distance is used to returna 
distance between two points. The last two PROCs draw 
and set up the vector font. 

Next month, we’ll finish the game by adding many of 
the trappings you’d expect from an old-school arcade. 
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» Snip offthecornerand [me ¢ Use sticky tape to 
poke a straw through : make a nice airtight 
seal around the straw 


i. 
VA 


Make sure you put the Pi = 
and battery pack in the ; — 
: second bag (not the one —= 

=~: = \ , you're blowing into) = = 


SENSE HAT SCIENCE: 


Latest version of 
Raspbian 
magpi.cc/ 
aMYYTMo 

A Sense HAT 


magpi.cc/ 


ATGGUts Create a humidity sensor and duplicate the experiment Tim Peake 


emacs has been running on the International Space Station 
oon oat n the last two issues, we used the Sense HAT A simple way to think of humidity is that it’s the 
atlding SIRS to investigate some of the properties of light amount of water vapour in the air. However, there 
and sticky tape and measure atmospheric pressure. This are different ways of measuring humidity. Absolute 
Craw Detector time, we’re going to experiment with another of the humidity is the water content of air at a certain 
code environmental sensors, and take a look at humidity temperature and is normally measured in grams/m3 , 
pcsanaast and the things that can influence it. whereas relative humidity is the amount of moisture 
Attach the Sense HAT to your Pi and power it up. in the air compared to what the air can ‘hold’ at that 
Se am Open IDLE3 or just type python3 in a terminal window, temperature, given as a percentage. The Sense HAT 
and then import the SenseHat library and connect reports relative humidity; this is useful for weather 
to the board: forecasting as the higher the value, the greater chance 
of precipitation (rain, dew, or fog). 
from sense_hat import SenseHat To make it easier to move around and measure 
sh = SenseHat() differences in humidity, let’s make our Pi portable. 
As with pressure measurements, we can take a Making gq sensor 
humidity reading with a single line: From last issue, you'll probably remember that the 
standard units for pressure are millibars, and normal 
sh.get_humidity() values tend to be at least three or four digits long. 
Therefore, when displaying our measurements, we 
This should produce a number like 32.87158203125 had to scroll them across the LED matrix. This time, 
(if you just get o back, run the command again). we can easily round our humidity values to the nearest 
What does this number mean? integer percent, because we should normally expect 
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the readings to be 0-99%. Two digits is an ideal size 
for displaying a number on the LED matrix, and we’ve 
written a handy Python module that makes it simple. 
You can install it by typing this at the command line: 


sudo pip-3.2 install twoDigit 


Once that’s done, download or type up the code from 
the listing, then start the program running by typing: 


python3 humidity.py 


Now disconnect the mouse, Keyboard, and monitor. 
The humidity reading should be displayed on the 
Sense HAT LED matrix every half a second. Just as with 
the pressure measurements, red text is used if the value 
is higher than the previous one, and green text if lower. 

Take your portable sensor for a walk and explore how 
humidity changes. You might notice a big change if you 
take the Pi outside. What differences do you see moving 
into a steamy kitchen or a bathroom? 


Controlled environment 

Obviously, a shower or a kettle can add lots of moisture 
to the air, but our bodies are also a great source of 
humidity. Let’s see how much effect we can have on our 
environment just through breathing. Take two sealable 
sandwich bags and snip the tip off one of the bottom 
corners on each. Cut off a short length of straw and 
poke an end through each of the corner holes, then use 
Sticky tape to seal up the bags around the straw. Now 
pick one of the bags, snip off the other bottom corner 
and seal it round the remainder of the straw. Put the Pi 
and its battery into the first bag (the one with a single 
straw). Finally, seal both of the bags up, making sure 
that they’re not too inflated. Blow into the long straw 
and watch the readings increase. Can you cause a rise 
to 100% relative humidity? 

You should quickly see why we used two bags rather 
than just one. The internal surfaces of the first bag will 
rapidly become covered in condensation, while the 
second — with the Pi inside — should stay drier. Always 
remember: electronics and water don’t go well together! 

Our Code Club’s winning entry for the Astro Pi 
competition used the humidity sensor to try to detect 
astronauts on the International Space Station. You 
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Can you increase the 
humidity to 100%? 
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SENSE HAT SCIENCE: HUMIDITY | Tutorial 


eye qanquage 
humidity -PYy >PYTHON 3 


import logging 

from twoDigit.twoDigit import numToMatrix 
from sense _hat import SenseHat 

from datetime import datetime 

from time import sleep 


DOWNLOAD: 
magpi.cc/1VLUJks 


# Set up the logfile name based on date/time 
logfile = “humidity-"+str(datetime.now().strftime( 
"SYN -ZHSM") +". cSv" 

# Logging settings and format for CSV 


logging. basicConfig(filename=logfile, level=logging.DEBUG, 


format='%(asctime)s %(message)s', 
datefmt='%Y-%m-%d, %H:%M:%S, ' ) 


sh = SenseHat() # Connect to Sense HAT 
h_old = @ 
col = [0,0,255] 


while True: # Main loop 


h = sh.get_humidity() # Take humidity reading 
logging.info(str(h)) # Log value to file 
if h > h_old: # If humidity has increased... 
col = [255,0,0] # Set to red 
else: # If humidity has decreased... 
col = [0,255,0] # Set to green 


h = int(round(h,@)) # Round to a whole percent 

i = numToMatrix(h,col) # Create 2-digit image for matrix 
sh.set_pixels(i) # Display reading 

sleep(@.5) 


h_old = h # Set previous value 


can download this code to see how well it works on Earth. 
Attach the Pi Camera Module and connect it back to mains 
power. Then type: 


git clone https://github.com/topshed/ 
SweatyAstronautCode 

cd 

python3 sweaty_astronaut.py 


The first thing you’ ll see is a slightly self-indulgent 
display of animations on the LED matrix. While this is 
in progress, set up the Pi where you’ re going to run the 
experiment. Once the animations have finished, you’ ll 
see a message saying that the program is starting. Keep 
away from the Pi for five minutes while it takes its baseline 
measurements. Once it has finished, you’1l see a message 
reporting that the experiment has started. See how near 
you need to get to the Pi to trigger a reaction; once the code 
thinks there has been a significant rise in humidity, it will 
ask if anyone is there and take a picture with the camera. 
You may need to tweak some of the settings in the code 
depending on your environment; see the README. md file 
for more information. 
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Tutorial 


))) Sonic Pi 


_ SAM AARON 


= Sam is the creator of Sonic Pi. By day he's 
a research associate at the University of 

» Cambridge Computer Laboratory; by night 
he writes code for people to dance to. 
sonic-pi.net 


We can slice 
up a sample and 
play the parts back 
in a different order 


In his latest musical coding piece, Sonic Pi creator Sam Aaron 
‘You Ul shows us how to slice and dice audio samples 
Need 


ay back in episode three of this Sonic Pi 


S RacODEIn Fi series, we looked at how to loop, stretch, How are samples 
running Raspbian and filter one of the most famous drum actually recorded? 
» Sonic Plv27+ breaks of all time: the Amen Break. In this tutorial, 
we’re going to take this one step further and learn 
> Speakers or aus . é 
eee ow to slice it up, shuffle the slices, and glue it back 
a 3.5mm jack together in a completely new order. If that sounds a 
> Update Sonic Pi: bit crazy to you, don’t worry: it will all become clear 
sudo apt-get and you’1l soon master a powerful new tool for your 


update && sudo 
apt-get install 
sonic-pi 


live-coded sets. 


Sound as data 

Before we get started, let’s just take a brief moment 
to understand how to work with samples. By now, 
you have all hopefully played with Sonic Pi’s powerful 
sampler. If not, there’s no time like the present! 

Boot up your Raspberry Pi, launch Sonic Pi from the 
Programming menu, type the following line into a 
fresh buffer, and then hit the Run button to hear a 
pre-recorded drum beat: 


sample :loop_amen 


A recording of a sound is simply represented as data: 
lots of numbers between -1 and 1, which represent the 
peaks and troughs of the sound wave (see the boxout 
to the right for more information). If we play those 
numbers back in order, we get the original sound. 
However, what’s to stop us from playing them back 
in a different order and creating a new sound? 
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Playing part of aq sample 

So, how do we code Sonic Pi to play a sample back 
in a different order? To answer this question, we 
need to take a look at the start: and finish: opts 
for sample. These let us control the start and finish 
positions of our playback of the numbers which 
represent the sound. 

The values for both of these opts are represented 
as anumber between @ and 1, where @ represents the 
start of the sample and 1 is the end.So, to play the 
first half of the Amen Break, we just need to specify a 
finish: of 0.5: 


sample :loop_amen, finish: @.5 


We can add ina start: value to play an even 
smaller section of the sample: 


Sample :loop_amen, start: @.25, finish: 0.5 


For fun, you can even have the finish: opt’s 
value set before start: , in which case it will play the 
section backwards: 


Sample :loop_amen, start: @.5, finish: 0.25 


Reordering sample playback 
Now that we know that a sample is simply a list 
of numbers that can be played back in any order, 
and also how to play a specific part of asample, we 
can start having fun playing a sample back in the 
‘wrong’ order. 

Let’s take our Amen Break and chop it up into 
eight equally sized slices, and then shuffle those 
pieces around to create a new drum break. 

Take another look at the Fig 1 diagram on the 
previous page: at the top, A) represents the graph 
of our original sample data. Chopping it into eight 
slices gives us B) — notice that we’ve given each slice a 
different colour to help distinguish them. You can see 
each slice’s start and finish values at the top. Finally, 
C) is one possible reordering of the slices. We can then 
play this back to create a new beat. Take a look at the 
code to do this: 


live loop :beat_slicer do 
Slice _idx = rand_i(8) 
slice size = 9.125 
s = slice _idx * slice size 
f = s + slice size 
sample :loop_amen, start: s, finish: f 
Sleep sample_duration :loop_amen, start: s, 
finish: f 
end 


Let’s analyse this piece of code to see precisely what 
is going on at each Stage... 
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SAMPLE SLICING 


1. We choose a random slice to play, which should 
be arandom number between 0 and 7 (remember 
that we start counting at 0). Sonic Pi has a handy 
function for exactly this: rand_i(8). We then store 
this random slice index in the variable slice_idx. 


2. We define our Slice_size, which is 1 divided by the 
number of slices (8), or @.125. We need this to convert 
our Slice_idx into a Slice starting position, as a value 
between 0 and 1. For example, the slice with index 3 
starts three slices into the sample: 3 * 0.125, or 0.375. 


3. We calculate the start position s by multiplying the 
Slice_idx by the slice_size. 


4. We calculate the finish position f by adding the 
slice_size to the Start position s. 


5. We can now play the slice by plugging in the s and f 
values into the start: and finish: opts for sample. 


6. Before we play the next slice, we need to know how 
long to sleep, which should be the duration of the 
sample slice. Luckily, Sonic Pi has us covered with 
sample_duration, which accepts all the same opts 

as sample and simply returns the duration. So, by 
passing sample_duration to our start: and finish: 
opts, we can find out the duration of a single slice. 


7. We wrap all of this code in a live_loop so that we 
continue to pick new random slices to play. 


Bringing it all together 

Let’s combine everything we’ve seen so far into a 
final example which demonstrates how we can take 
a Similar approach to combine randomly sliced beats 
with some bass to create the start of an interesting 
track. Now it’s your turn: take this code as a starting 
point and see if you can create something new... 


live_loop :sliced_amen do 


n= 8 
s = line(@, 1, steps: n).choose 
f=s + (1.0 / n) 


sample :loop_amen, beat_stretch: 2, start: s, finish: f 
sleep 2.0 /n 
end 


live _loop :acid bass do 
with _fx :reverb, room: 1, reps: 32, amp: @.6 do 
tick 
n = (octs :e@, 3).look - (knit @, 3 * 8, -4, 3 * 8).look 
co = rrand(7@, 110) 


synth :beep, note: n + 36, release: 0.1, wave: 0, cutoff: 


synth :tb303, note: n, release: 0.2, wave: @, cutoff: co 
sleep (ring 0.125, @.25).look 
end 
end 
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AGPIO adapter allows us to 
extend the reach of the display 
from the Raspberry Pi 


Get Power-over-Ethernet (PoE) 
with this HAT to cut back on 


cables 


The PaPiRus elnk 
display shows 
information about 
the network you're 
connected to 


BUILD A RASPBERRY PI 
ACCESS POINT 
WITH A DISPLAY 


Build a professional-looking access point with a Raspberry Pi, 
that gives you relevant info on a PaPiRus screen 
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PaPiRus ePaper / 


elnk Screen HAT 
magpli.cc/ 
1OAObXV 


Pi PoE Switch 
HAT 
magpi.cc/ 
1T3WhnnB 


TP-LINK PoE 
Injector (optional) 
magpli.cc/ 
1T3Wq2N 


40-pin header 
magpi.cc/ 
1VV5Zx2 


GPIO adapter for 
RPi-Display B+ - 
female 
magpi.cc/ 
1VV5ERe 


PuTTY 
magpi.cc/ 
aMm5Npi 
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his article features the PaPiRus, the Pi PoE, 
and the Raspberry Pi 3 to build a portable 
access point with a screen. We will be working 
with the Pi PoE, but everything in this tutorial can be 
achieved without it, too. This tutorial assumes your 
version of Raspbian Jessie is up-to-date. 


Putting everything together 

Building this access point is extremely easy. It requires 
minimal soldering and for the rest, it’s really just a 
question of stacking together the various components. 

The additional header will allow us to install the 
PaPiRus on top of the Pi PoE, but we did this via the 
GPIO adapter. 

In some cases, your infrastructure will already be able 
to deliver Power over Ethernet; if not, you’1l need to use 
a PoE injector like the TP-LINK TL-POE150S. 

Connect everything up, making sure that the 
flat cable for the PaPiRus is connected the right 
way around. 


Once all is connected and ready to use, a long 
press on the switch of the Pi PoE module will power 
up the system. 


Preparing the access point 

For the initial preparation, we need to enable SPI. 

Go to the program menu and find the Raspberry Pi 
Configuration menu to make sure it’s enabled in the 
Interfaces tab. Reboot the Raspberry Pi. We’re now 
ready to install and configure hostapd, which we will 
use to create the AP part of our system. 


sudo apt-get install hostapd 


Then we need to create the configuration file as 
follows. Note that the file doesn’t exist and that we’re 
creating a brand new one. 

This is the right time to download the supporting 
code from GitHub, which also contains the templates 
for the configuration files. 
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git clone https://github.com/francesco- 
vannini/PaPiRus-AP.git 


Open the hostapd.conf template file in the 
terminal with: 


sudo nano PaPiRus-AP/hostapd. conf 


Replace the values for ssid and wpa_passphrase in 
this conf file with details for your network, then copy 
the file hostapd.conf to the correct directory: 


sudo cp PaPiRus-AP/hostapd.conf /etc/hostapd 


At this point, we need to edit the following file to 
make hostapd use the above configuration at startup. 
Open the file with sudo nano /etc/default/ 
hostapd and change it by adding: 


DAEMON_CONF="/etc/hostapd/hostapd.conf" 
Lastly, we start the service with sudo systemctl 

start hostapd. We really want this configuration 

not to depend on services that will automatically 


alter our network settings, so we’|l disable dhcpcd: 


sudo systemctl disable dhcpcd 


Now we need to install bridge-utils, which will allow 


us to merge the Ethernet and wireless interfaces: 
sudo apt-get install bridge-utils 


Once that’s done, we can configure our networking 
using the template provided. Open it with sudo nano 
PaPiRus-AP/interfaces and edit the details in the 
‘Bridge setup’ section. 

Now back up your existing file: 


sudo mv /etc/network/interfaces /etc/ 
network/interfaces.bck 


Copy the new one in: 
sudo cp PaPiRus-AP/interfaces /etc/network/ 


At this point, you can reboot your Pi and if all is good, 
you should find a new AP with the SSID you choose! 
You can now connect via the bro IP that you specified. 
The access point is ready. Devices connecting to it 
should get their IP from the DHCP on your home/office 
router and be able to browse the internet. Great! 


Get the PaPiRus ready 


Whereas for the Pi PoE there are no software steps 
involved, for the PaPiRus we need to install drivers 
and packages. These will also provide some ready- 
made examples we could use to test all is working, 
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BUILD AN ACCESS POINT 


before turning to the code that will allow us to 
manage the AP. 

To install the PaPiRus software, execute the 
following command from your home folder — if you’re 
unsure where you are, just enter cd~ to get back to 
your home directory. 


curl -sSL https://goo.gl/NzzRXa | sudo bash 


The installation should be fairly quick, and resolve 
various dependencies for the packages required to use 
the PaPiRus screen. 

Once the installation is finished, we need to tell 
the system which screen we’re going to use. We’ve 
created the scripts to manage the AP for a 2.7-inch 
screen (the biggest). In this case, we need to run: 


sudo papirus-set 2.7 
If all goes well, you can test it with: 
sudo papirus-clock 


You should see a nice clock on your PaPiRus. We’re 
now nearly done, and one step away from getting our 
AP ready for business. 


Run the management script 

We’ve created some demo code to display various 
information about the AP on the PaPiRus. By using the 
four switches, you’ ll be able to access network stats and 
basic information about the AP configuration. Run: 


sudo python PaPiRus-AP/APInfo.py & 


Your PaPiRus screen should spring to life and 
display your SSID and AP IP address. By pressing 
switch 2, you get to see some bandwidth info; by 
pressing switch 3, you get a detailed view of the AP 
networking setup. 

You now have a very nice, portable access point to 
carry with you at Raspberry Pi Jams or hackathons, or 
wherever your Pi will take you next. 


Tutorial 


Left It doesn't look 
all that much, but 
it's all you need to 
build the PaPiRus 
access point 


ACCESS 
POINT 
DIFFERENCES 


There are 

a couple of 
methods that 
can be used to 
create an AP 
at the OS level. 
In this tutorial, 
we decided 

to implement 
the AP as an 
ISO layer 2 
device, which 
is a fancy way 
to say that 
there won't be 
any routing, 
firewall, or 
NAT involved. 
The device 
will ‘merge’ 
the Ethernet 
network card 
and the WiFi 
into a bridge; it 
will only have 
one IP address 
and will, in fact, 
behave asa 
typical AP and 
not as ahome 
broadband 
router. 


DHCP 
REQUIRED 


The AP won't 
serve asa 
DHCP, so it's 
essential that 
you have one 
enabled on 
your router. 
The first part of 
the setup also 
requires that 
the Pi receives 
an IP from 

the router, in 
order to get all 
the packages 
required off 
the internet. 
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Hairgrips to hold resistors 


ee | 


> 16x 33mm 
spring hairgrips 


> 240 x 140 x 6mm 
board 


> 74HC4051 
analogue switch 


> MCP3002 
A/D chip 


> 0.1UF ceramic 
capacitor 


> 8x 10K resistors 


> 1K to 22K pot, 
bracket and knob 


> 2x push buttons 


> 16-pin DIL IC 
socket 


> 8-pin DIL IC 
socket 


> Stripboard and 
mounting pillars 


> 16x solder tags 


> 16x M3 10mm 
countersunk 
screws & nuts 


> GPIO connector 
socket 
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Resistor defines the note 


Multiplexer and A/D converter 


Hairgrips hold the key to a good music sequence. Build your own in easy steps... 


ome months back, we were doing some work 

with Drake Music, who specialise in musical 

applications for the disabled. We were asked 
to come up with a stand-alone physical sequencer. 
This proved to be so popular that we thought we 
would do a Raspberry Pi version to take advantage of 
the sample-playing capabilities of the Pi. 


The project 

In a physical sequencer, some object represents a 
note, and where it’s placed represents where that 
note appears in the sequence. Here, a note or sample 
is represented by a resistor, and its position by what 
pair of clips it’s fastened to. After some research, 
the cheapest form of clip we found was a hairgrip or 


clip, hence the name of this project. The concept 
is quite simple: a multiplexer switches one of 
eight resistors to an A/D (analogue-to-digital) 
converter, which is measured and turned into a 
sample number. A second A/D channel converts a 
potentiometer output into a number that’s used 
to determine the time between each step of the 
sequencer. The block diagram of the project is 
shown in Fig 1 (overleaf). Note that for each pair 
of clips, a pull up resistor and note-determining 
resistor are shown: once in detail in the dotted 
box, and seven other times as a block to make 
the diagram simpler. Remember, a multiplexer 
is simply a big eight-way switch controlled from 
the Pi’s GPIO lines. While the Pi doesn’t have 
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tier 
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a built-in A/D converter, adding an external one 

is straightforward. We chose the low-cost, two- 
channel MCP3002 10-bit A/D. Even better, our 
normal interface library, WiringPi, has a driver for 
this chip already included, so talking to it is easy. 


The hardware 

The schematic of the project is shown in Fig 2 
(overleaf). The data select chip is a 74HC4051, and 
the whole circuit is run from the 3V3 voltage rail. 
This way, you don’t have to do any level shifting 

on the signal lines. Note that in the contents of the 
block diagram there are two push buttons labelled 
start/stop and mode — more on this later. Details 

of construction are in the ‘Making the sequencer’ 
step-by-step section. The A/D measurements you 
eet from a resistor will not be precise due to the 

5% tolerance of each resistor, so there is a range 

of values you could get. In order to identify what 
resistor you have, a sequence of threshold values was 
calculated using a spreadsheet — this is available in 
the GitHub repository, along with all the files needed 
for this project. 
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>STEP-01 

Prepare the base 

Drilla 3mm hole at the end of each hair clip. Hold the clip in a pair of 
pliers while you do this. Drill 3mm holes in the laminate flooring 7omm 
apart for each pair of clips, and space the clip pairs about 20mm 

apart to give good room to access them. Countersink the underside 
of the flooring, so the 3M screws poke up a minimum amount - if too 
much thread shows, the clips won't open fully when pressed. Take a 
small piece of angle aluminium and drill it to accommodate the pot; 
remember to drill the second hole/slot for the pot's anti-rotation lug as 
well. In the other side of the angle, drill two 3mm holes to 


mount it to the board, and drill and countersink holes in the 
board to match. 


The software 

As well as having WiringPi installed, you need to enable 
the SPI drivers. There are many ways to do this, but 
perhaps the simplest is to open a terminal window 

and type sudo raspi-config. Then, from the menu, 
pick ‘Option 9 - Advanced Options’, choose ‘A6 SPI’ 
and enable the SPI, then reboot. The code is in the 
hard_time.py listing (on page 62) and it needs two 

sets of samples to play. These are in OGG format and 
were created using Audacity; the individual samples are 
named so to s14 and cover two octaves in the key of C. 
The samples are stored in a directory at the same level 
as the program, and are called piano_sounds and 
marimber_sounds — can you guess what they are? 
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Tutorial WALKTHROUGH 


>STEP-03 

Cut the tracks 

Prepare a 15-by-25-hole piece of stripboard. 
Drill 3mm holes in each of the corners, as 
shown, and fit to four 10mm pillars. Drill and 
countersink the base board to suit. Then 

flip the board over and cut the tracks on the 
rear side of the board with a spot face cutter 
or scalpel, at the places shown in the diagram. 


Underside 
of Board 


Clip 03 


Clip 00 GPIO 23 Clip 11 
Clip 02 _ GPIO 24 elie 09 
Clip 03 GPIO 25 Clip 10 


f f 


GPIO 08 


Clip 06 
Clip 07 Pot Wiper 
: Pot Ground 
Clip 05 
Clip 04 Common Clip 


GPIO 02 GPIO 03 GPIO Gnd 
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>STEP-02 

Mount the clips 

Fix the hair clips to the board. 
Make a sandwich with solder tag, 
clip and nut, then tighten the nut 
up very tight so it won't rotate. 

Use some glue if you want, but 

we didn't need any. If the clip is 
bent and doesn't sit flat against 
the board, then place a small 
screwdriver under the clip close 
to the screw, and push the clip flat 
against the board. Wire and solder 
one side of the clips together, and 
connect to ground on the circuit 
board. The other clip in each pair 
should be wired to the appropriate 
pin of the multiplexer chip. 


>STEP-04 

Make the circuit 

Now flip the board over and fit the 
components, the internal board 
wires, and solid copper wires. 
The diagram shows the strips as 
seen through the board. Note 
the wire connecting pin 16 of 
the multiplexer chip underneath 
the board is also attached to 
the adjacent track where the 
wire enters the board. Once the 
board is complete, wire up the 
external connections. These are 
the wires to the Raspberry Pi's 
GPIO port connector, along with 
the connections to the hair clips 
and the speed control pot. The 
tactile switches used were the 
two-contact type; a small change 
is needed to accommodate the 
four-legged type. 
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‘Clip resistor 


Pull Up resistor 


10K 
Clip 
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Clip resistor 


Clip resistor 
Clip resistor 


Clip resistor 


Clip resistor 
Clip resistor 
Clip resistor 


Clip resistor 


The setMux function outputs the multiplexer address 
on the appropriate pins; the readAD function reads 
the value from channel o of the A/D, works out what 
resistor is placed, if any, and plays the appropriate 
sample. Working out the sample number is easy: just 
search through the threshold list until the sample 
is greater than the threshold. The entry when this 
happens is the sample number to play. Well, nearly: 
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Fig 1 Block diagram of the sequencer 


Data select chip 


A/D converter 


CHO 


CH1 


Raspberry Pi 
GPIO 


Taking it further 

The simplest thing you can do is to change the 
samples; perhaps one of the most effective things is 
changing them to percussion sounds to have a drum 
sample player. There are two other variants of the 
code on GitHub: one where the sound doesn’t change 
when the sequence plays backwards, and another 
where the sequence is repeated at a slightly different 


One of the most effective alterations you can make 1s 
to change the samples to percussion sounds 


in order to have nothing played when there is a short 
circuit, the sample is shifted by one place in the 
threshold list. The resistor values needed to produce 
a note are shown in the listing, underneath the 
threshold list. 


Operation 

In operation, pressing the ‘start’ button begins the 
sequence; it will repeat indefinitely until the button 

is pushed again, whereupon it will stop at the end of 
the next complete cycle of the sequence. You will see 
a stopping message followed by a stopped message 

in the Python console window. When the sequencer is 
running, you can press the ‘mode’ button, whereupon 
the sequence will be played in reverse order ona 
different instrument. 
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speed, so the two drift in and out of phase with each 
other in a Steve Reich sort of way. 

One fun thing to do is to replace one or more of the 
resistors with an LDR (light-dependent resistor), and 
then the sequence can change as you cover it up with 
your hand. You can also change the threshold list and 
have more than just two octaves of samples. 

For the adventurous, you can easily extend the 
project to 16 or more inputs. Pin 6 on the 74HC4051 is 
an enable pin; this is set to be permanently enabled. 
However, if you take this pin to a GPIO line and do 
the same with another 74HC4051, you can double the 
number of inputs. All the other pins on this second 
multiplexer are wired in common with the first. By 
repeating this with more multiplexer chips, you can 
add as many steps as you like to the sequencer. 
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— -PYy 15. for sound in range(@,15) ] 


16. altSound = [ pygame.mixer.Sound( 


Q@1. #!/usr/bin/env python "piano_sounds/s"+str(sound)+".ogg”" ) 
Q@2. # Get a Grip - physical sequencer ie ae for sound in range(@,15) ] 
Q@3. # Version 1 reverse mode switch alt sound 18. 

# on reverse 19. startPush = 2; modePush = 3 
04. 20. lastStart = 1; lastMode = 1 
Q@5. import time, pygame 21. muxPins = [| 23,24,25] 
Q6. import os, sys 22. threshold = [80,153, 235,290, 370,426,475,535,586, 636,68 
Q@7. import wiringpi2 as io 1,745,816,879,922,950, 1024 | 
08. 23. #note C D E E G A B C D E 
Q9. pygame.init() # initialise pygame # F G A B G 
18. pygame.mixer.quit() 24. # 1K 2K7 3K3 4K7 6K8 7K5 10K 12K 15K 18K 
11. pygame.mixer.init(frequency=22050, # 22K 33K 47K 82K 100K 
12. size=-16, channels=8, buffer=512) 25. 

26. def main(): 
13. pygame.event.set_allowed(None) 278 global clip, stop, pendingStop, mode 
14. seqSound = [ pygame.mixer.Sound( 28. initGPIO( ) 
3V3 
All 10K 
3V3 
Clips 
Raspberry Pi a 0 
GPIO connector 
1 


2 
GPIO 23 
3 
GPIO 24 
A 
GPIO 25 
5 
6 
GPIO 2 4 Start / Stop ] 
3V3 
VR1 
GPIO 3 ———=) Made 
1K 
to 
zs Speed 
GPIO 10 zal 
D out 
GPIO 9 
CLK 
GPIO 711 
CS 
GPIO 8 
Gnd 


Fig 2 Schematic of the sequencer 
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print"Get A Grip - sequencer" 
clip=0 
Stop = False ; mode = True 
pendingStop = False 
while True: 
if io.digitalRead(modePush) == @ and 
io.digitalRead(startPush) == 
terminate() 
if not stop : 
stepTime = @.004 + ( 
io.analogRead(71) / 2000.0) 
nextStep = time.time() + stepTime 
setMux(clip) 
while time.time() <= nextStep : 
readStart() 
readMode ( ) 
readAD(clip) 
incrementClip() 
else : 
readStart() 


def incrementClip(): 
global clip, stop, pendingStop, mode 
if mode : 
clip += 1 
aly ga (G)) ball p> Y fae 
clip= @ 
if pendingStop : 
stop = True 
pendingStop = False 
print" stopped" 
else : 
clip -= 1 
gga @llal ope <a). 
clip= 7 
if pendingStop : 
stop = True 
pendingStop = False 
print" stopped" 


def readMode(): 
global mode, lastMode, clip 
current = i0.digitalRead(modePush) 
if current == @ and lastMode == 
time.sleep(@.02) # debounce delay 
mode = not mode 


if mode : 
print"forward mode" 
clip = @ 

else : 
print"reverse mode" 
clip = 7 


lastMode = current 


def readStart(): # start / stop control 
global stop, pendingStop, lastStart 
current = io.digitalRead(startPush) 
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if current == @ and 
lastStart == 1: >PYTHON 
time.sleep(@.02) # debounce 
DOWNLOAD: 
if stop : magpi.cc/1NqJjmV 
stop = False 
or on PROJECT 
print running VIDEOS 
else : 
pendingStop = True Check out Mike's 
print"stopping" Bakery videos at: 


magpi.cc/1NqJnTz 


lastStart = current 


def readAD(step) : 
value = io.analogRead(70) # read multiplex 
look = @ 
while value >= threshold[ look |: 
look +=1 
if look>@ and look <16 : 
if mode : 
seqgSound[ look-1].play() 
else: 
altSound[ look-1].play() 


def setMux(n): 
mask = 1; 
for pin in range(@,3): 
if (mask &n) !=@: 
io.digitalWrite(muxPins[pin], 1) 
else ; 
io.digitalwWrite(muxPins[pin], 0) 
mask = mask << 1 


def initGPIO(): 
try: 
io.wiringPiSetupGpio() 
except : 
print"start IDLE with ‘gksudo idle' from terminal" 


os. exit(1) 
for pin in range (@,3): 

io.pinMode(muxPins[pin],1) # mux pin to output 
io.pinMode(startPush,@) # start / stop input 
io.pinMode(modePush,@) # mode input 
io.pullUpDnControl(startPush,2) # input enable pull up 
io.pullUpDnControl(modePush,2) # input enable pull up 
i0.mcp30@2Setup( 72,2) 


def terminate(): # close down the program 
print"closing down" 
pygame.mixer.quit() 
pygame.quit() # close pygame 
os._exit(1) 


if name == '_ main_': 
main() 
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> First-generation 
Raspberry Pi 


(A+, B+, Zero, etc.) 


> NeoPixel ring 


> 4x AA battery 


pack, preferably 
with a switch 


> 4x rechargeable 
AA batteries 


> Portable 
mobile phone 
power bank 


> Push button 


> Various wires 
and resistors 
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Four rechargeable 
batteries will 
adequately power 
the NeoPixel ring, 
whereas the Pi 
will not 
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Asimple push button can be hidden in a pocket 
to activate the colour changes in the ring 


MAKE 


Ground 


ROB ZWETSLOOT 


_ Tinkerer, sometimes maker, 
other-times cosplayer, and 
all the time features editor 
of The MagPi. 

magpi.cc 


The lights are attached behind black chiffon to slightly 
obscure them, and allow the cosplayer's face to remain 
hidden while still being able to see 


COSPLAY EYES WITH PI 


Create your own powerful eyes for Sans from Undertale, by getting some 
LEDs and a NeoPixel ring. It’1] be a skele-ton of fun! 


eoPixels are amazing, addressable RGB LEDs 

from Adafruit. You can get them in strips, 

rings or individually, and create incredible 
effects with them. However, it’s not always clear how 
to control them on the Raspberry Pi. 

Recently, friend of the mag Mel Nurdin (of 
Riddlerule Cosplay: magpi.cc/1Q20QCJ) expressed an 
interest in using NeoPixels in a cosplay of theirs. We 
decided to cut through the information and create a 
Pi-powered pair of eyes for their costume: skeleton 
pun-maker and hotdog salesman Sans from last year’s 
excellent Undertale game. Follow along to make your 
own Megalovania eyes, or learn how to use NeoPixels 
in general for your own projects. 


Prepare your Pi 

A Raspberry Pi Zero was used in the final build, so it 
would fit better within the confines of the costume. 
Update a version of Raspbian Jessie by going into the 
terminal and using sudo apt-get update then sudo 
apt-get upgrade, before installing the software 
needed for the NeoPixels: 


sudo apt-get install build-essential 
python-dev git scons swig 


Now download the library for the NeoPixels: 


git clone https://github.com/jgarff/ 
rpi_ws281x. git 

cd rpi_ws281x 

scons 


Finally, we can install the module to the Pi: 


cd python 
sudo python setup.py install 


Wire up the NeoPixel 

It’s worth testing this out on a breadboard first, so you 
can understand the concept of the circuit. Basically, 
the NeoPixel needs to be powered separately by the 
four AA batteries, with a data cable coming from 

a PWM-enabled pin on the Pi to control the LEDs. 
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#!/usr/bin/env python 
import time 

from gpiozero import Button 
from neopixel import * 
button = Button(21) 


# LED strip configuration: 


LED COUNT = 16 # Number of LED pixels 

LED PIN = 18 # GPIO pin 

LED FREQ HZ = 800000 # LED signal frequency in hertz 
LED DMA = 5 # DMA channel to use for 


# generating signal 
#LED BRIGHTNESS = 255 # LED brightness 
LED INVERT = False’ # True to invert the signal 


# Function to control colour change 


def Megalovania(strip, color): 
iterations = @ 
for i in range(strip.numPixels()): 
strip.setPixelColor(i, color) 


You don’t need to step up the 3V3 signal from the Pi to 
do this, so to keep it simple, we’re not. The main thing 
to remember is that the ground of the NeoPixel needs 
to be connected to the negative on the battery pack 
and a ground on the Raspberry Pi. We’ve connected 
the data pin for the NeoPixel to pin 6 (GPIO 18). 
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USE NEOPIXELS 


strip. show( ) 


# Create NeoPixel object with 
# appropriate configuration 
Strip = Adafruit_NeoPixel(LED_ 
COUNT, LED PIN, LED FREQ HZ, 
LED DMA, LED INVERT) 

# Initalise the library (must be called once before 
# other functions) 

Strip.begin() 


DOWNLOAD: 


magpi.cc/SansEyes 


Megalovania(strip, Color(255,255,255)) 
time.sleep(2) 


while True: 

Megalovania(strip, Color(@,0,0)) # Eyes off 

time.sleep(@.5) 

button.wait_for_press() 

Megalovania(strip, Color(@,0,255)) # Blue eye 

time.sleep(@.5) 

button.wait_for_press() 

time.sleep(@.5) 

while button.is pressed == False: 
Megalovania(strip, Color(255,255,0)) # Yellow eye 
time.sleep(@.1) 
Megalovania(strip, Color(@,0,255)) # Blue eye 
time.sleep(@.1) 


make them turn blue, and another button press will 
make the LEDs flash blue and yellow quite quickly, 
emulating a specific scenario in the game Undertale. 
Add this command to the end of the file /etc/profile 
so it will run on boot. 


>STEP-05 


>STEP-03 

Wire up the button 

The button is the easy one to wire up. It doesn’t 
matter which way around it goes, but we have it 
connected to pin 40 right at the end and to ground on 
pin 34, to keep it away from the NeoPixel wires. You’ 1] 
also need a resistor suitable for your button — ours 
uses a 470 ohm resistor — and it can be connected to 
either side of the button. This is controlled by GPIO 
Zero, so it’s addressed at GPIO 21 in the code. 


>STEP-04 

Add the code 

Type up or download the code to the Raspberry Pi. 
You can either put it in the home folder or in its own 
folder; either way, you can test it by running it in the 
terminal with: 


How the code works 

Each NeoPixel in a series can be addressed individually. 
As the code only needs to have all the lights the same 
colour at one time, we’ve created a for loop in the main 
function that goes through and sets each LED to the 
same colour one by one. We’ve also told the code how 
many LEDs there are, where they’re connected, and 
what frequency to use for refreshing them. The rest of 
the code is fairly straightforward, waiting for button 
presses and using delays to manage them. 


>STEP-06 

Finishing up 

That’s the pure circuit, but how is it used in the 
costume? Mel installed a ring of frosted acrylic into the 
skull she made and stuck the NeoPixel ring behind it: 
this served to diffuse the individual lights into a more 


coherent ring. Normal white LEDs were mounted in 


sudo python eyes.py 


both eye sockets and controlled by a separate switch 


for the ‘normal’ eyes. The button from the Pi was ona 


It should light up the LEDs white for a couple of 
seconds before turning them off. A button press will 
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long enough cable that it fit sneakily into her pocket - 
useful, as the character keeps his hands in them! 
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Est OR ER GARD 


Building your arcade machine is an amazing idea, and there are projects galore from 
other makers. Follow in the footsteps of these builds to have your own coin-op at home 


he Raspberry Pi has long been the beating 
T heart of many an arcade machine project, 
and the souped-up Raspberry Pi 3 emulates 
COMO Welle Milani cwcin 
So if you’ve ever schemed and dreamed of your own 
personal arcade machine, now’s the time to put your 
plan into action. 
You might be pondering what type of arcade 
machine you’d like to build: a full-sized cabinet, 


*e a bartop device, or a cool tabletop machine? Whatever 
m you choose, the Raspberry Pi community has your 
 - —— back. There are designs and concepts for every 


conceivable shape and size of arcade machine. Some 
are incredibly detailed, others purely practical, and 
most look plain fun to build (and play). 
Most arcade projects run RetroPie 
(magpi.cc/Retro-Pie) or PiPlay (piplay.org), 
although there are other options like Lakka (lakka.tv). 
Ignition.io (ignition.io) is worth watching, too: it’s 
in beta but adds modern features like friends lists, 
achievements, and online gaming to retro games. 
Building an arcade machine is an incredibly 
rewarding project, and no matter what type of 
machine you end up with, you’re bound to enjoy using 
it and showing it off to your friends. 
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MATT SHAW 


Matt Shaw, is a keen gamer who 
lives in Adelaide, Australia. He was 
formerly a boilermaker and welder, 
and has always had a penchant for 


making things. 
imgur.com/a/wzua5 \ 24) 


Apiece of glass recycled from 
A square cut on the top an old table is installed on top 
of the barrel holds the of the screen and held in place 
4:3 monitor in place I bes with non-slip rubber edging 


—_ 4 5 A 


ARCAD 


Drain a barrel of wine and turn it into 
a Donkey Kong-style arcade table 


We adore this grand Donkey Kong-style barrel 
transformed into a tabletop arcade machine. 

Built by Matt Smith, a gamer from Adelaide, 
Australia, the Wine Barrel Arcade (magpi.cc/1S4DI8E) 
is a Surprisingly low-tech project. There’s no soldering, 
and it uses crimps and block connectors to hold 
everything in place. All you’d need is a ludicrously 
oversized barrel and space to store it. 


Matt based the idea on an earlier project called A aa ) “ | An MDF wood 
; The oak wine panetis cut to fit 
Barrel of Kong (magpi.cc/1VwrzPK), although that barrel fone = - y exadtly aroulta 
project featured a JAMMA board (to accept original : the cabinet. ~— _ ; the wine barrel. 
arcade machine boards). “With a mind to do something he power laas rr ee el Me Teds) 
i runs from the a —s the joystick 
like that, I asked for a wine barrel for Christmas,” he bottom, up the = ey and buttons 


says. Sensibly, Matt switched the JAMMA arcade board pin the 
approach of that project to a Raspberry Pi running 
PiPlay (piplay.org). 
With a wine barrel rolled into his workshop, Matt the buttons, joysticks, and wiring. These are all held 
sourced an unloved 4:3 monitor and table glass together with an MDF panel, cut to fit using an angle 
mounted on non-slip rubber. The only real cost was for — grinder, circular saw, and jigsaw. According to Matt, 
the whole build came in at around £90. 
“The guys at the PiPlay forum were amazing, and 


still help me out (and anyone else that asks, it seems) > Wine barrel 

today,” Matt told Australian Kotaku (kotaku.com.au).”'! > 4:3 TFT monitor 
a) 

love Wonder Boy, as it s such fun and a long sum but sioveticcend 

the Street Fighter II series [is] the best.” Matt enjoys epic buttons 


Street Fighter battles with his friends over beers. 

It’s visually impressive, but the best thing about the 
Wine Barrel Arcade machine is that despite the size, 
it’s arelatively basic construction. We think this is one 
of the most impressive projects you can make — and if 
you’ve got the space, it’s sure to impress. 


> MDF board oe 


The insides reveal the low-tech 
way everything is connected up 


=: —— 
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The NaCade is 
a neat tabletop po i 
arcade machine Lai 


made fromaclear | 
acrylic sheet so 

you can view : 

the insides ; 


This desktop cabinet is a fully functioning arcade 
machine with a Raspberry Pi inside 


A unique approach to building an arcade machine is this 
Micro Pi, designed by Marco Tan. Roughly the size of a 
can of Coke, it’s still a perfectly formed arcade machine. 
“T always wanted a tiny arcade machine for my desk,” 
explains Marco, “[so] I decided to build it as small as 
possible. It may look simple from the outside, but a lot 
of engineering went into making it. After months of 
development and eight printed prototypes later, it’s 
finally ready.” 
The cabinet is 3D printed with nylon SLS (Selective 
Laser Sintering). “It needs to be printed with 
nylon SLS, or else it won’t work: it won’t be strong Don’t be shy! Show off your 
eee says MIRC: You can buy a case directly from Raspberry Pj with pride inside this 
apeways (magpi.cc/1S4FqXV). 
The controls are a GH7455-ND mini joystick and see-through arcade machine 
nine 679-2431-ND tactile push buttons. Epoxy is used 07 
RepoeR-audelielaremce-Mllcki-naneccrw meme § “Who doesn’t like gaming°” asks Krimmy, creator 
soldering in the project. A speaker is recycled from an of the NaCade. “Having grown up playing arcade 
old MP3 player to provide audio, and a 2.5-inch TFT machines, as a kid you could only dream of owning one. 
forms the display. Now, with advances in technology, gaming is available 
It’s a fiddly project, but it uses widely available parts, to everybody.” 
and the case can be pre-bought. There are full details on NaCade (magpi.cc/1S4HSgV) is a naked arcade machine 
Marco’s Instructables page (magpi.cc/1S4Fw11I). case, displaying the Raspberry Pi powered innards in all 
We think this is one of the cutest projects we’ve ever their glory. The display is a 7-inch LCD monitor recycled 
seen, and it’s a superb way to creating a dinky arcade from a car reversing system. “[The display] is sufficient 
machine that’s fully functional. enough for these low-resolution games,” says Krimmy, 
“although the menus can be a bit too small to read. 
I had to use a larger monitor when | set it up. 
“T used an arcade-quality joystick and illuminated 
buttons, which are wired directly into the Pi,” he adds. 
Just when you think the NaCade couldn’t get any 
cooler, Krimmy drops the solar panel on you. “The solar 
controller regulates voltage from an external source, 
which in this case is a solar panel. Yes, it’s powered 
by the sun! 
“Sure, there [are] plenty of consoles and handheld 
units, even smartphones to choose from, but what 
I wanted was the nostalgic feel of a stand-up arcade 
without the need for a large room to put it in. 
The portability is pretty handy, too.” 


The Micro Pi packs 

a fully functioning 
arcade machine intoa 
Coke can-sized cabinet 
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STARCADE| 


TEN AMAZING ARCADE MACHINE PROJECTS 


With clear instructions and a solid parts list, 
this superb arcade machine is a rewarding build 


> MDF board 


> LCD TFT 
monitor 


> Joystick and 
buttons 


> Heatsink for 
Raspberry Pi 


> Plexiglas and 
flexible LED 
strip kit 


raspberry 


The Galactic Starcade is a great bartop project that 
keeps the weight (and cost) down while providing two 
sets of controls and a large 19-inch TFT monitor. 

Built by Bristolian techie Tom Rolfe, the Starcade 
(magpi.cc/1qOxaVh) is our tip for a solid arcade cabinet 
with clear instructions. It’s a challenging project, but 
you won’t get lost during the build. 

“T’ve always wanted an arcade machine for authentic 
retro gaming,” reveals Tom, “but they take up a lot of 
space and cost a lot of money. Making a custom bartop 
cabinet like this one solves both of those problems. It 
also lets you play potentially thousands of games on a 
single machine. This project costs under £200 ($280) to 
make, whereas a pre-built custom cabinet can set you 
back four or five times that amount.” 

What we like most about the Galactic Starcade is the 
amount of detail in Tom’s instructions. “I’ve knocked 
up full 1:1 scale printable guides for the side panels and 
the control deck, plus a reference sheet with dimensions 
and angles for the rest of the panels,” says Tom. You’ll 
find this project easier to follow than many others. 

The cabinet is made from painted MDF, and the 
marquee is Plexiglas and a flexible LED strip kit. A 
Raspberry Pi is used along with a heatsink to keep 
things cool, and the controls are from Ultracabs 
(ultracabs.co.uk). It uses RetroPie as the software. 

“There’s a few things I would do differently, but 
overall I’m very happy with how this turned out,” 

says Tom. “It proves that a little thing like the 
Raspberry Pi can happily power a near 
full-size arcade machine.” 


feature 


TOM ROLFE 


Tom Rolfe is a writer 
for TapSmart and 
Swipe magazine. 
tapsmart.com 


The controls are an 
all-in-one unit with 
a USB interface and 
pre-crimped wires 


The cabinet is made from 
regular MDF (medium- 
density fibreboard) cut to 
shape and glued together 
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A1g-inch LCD TFT 
monitor with built-in 
speakers provides both 
video and audio output 


A hinge on the rear of 
the cabinet provides 
quick access to the 
Raspberry Pi inside 


The cabinet is a repurposed 
Ikea Lack table, which saves 
you the effort of making a 
cabinet from scratch 


Some ideas are pure genius, like this Ikea coffee 
table turned into an arcade machine 


> Ikea Lack 
coffee table 


> Raspberry Pi 
and Arduino 
Leonardo 


> Four-way ball- 
top joystick 
and buttons 


> 17-inch LCD 
monitor 


> USB computer 
speakers 


We love getting ideas in Ikea, but clearly not as 
much as Element 14’s community manager, Spanner 
Spencer, who had the genius to take apart an Ikea 
coffee table and turn it into an arcade table. 

“Tt’s an IKEA Lack coffee table with an LCD monitor 
Cul MO tne top, dreade Comirols Next te tiie ilominen, 
and a Raspberry Pi 3 and accessories buried inside,” 
explains Spanner. 

He describes it as a “minimalist, contemporary 
interpretation of the classic coin-op cocktail cabinet 
that uses an IKEA coffee table and a Raspberry Pi 3.” 

The display is an old 17-inch LCD monitor with a 4:3 
ratio (this shape is better to match the square table). 
The chassis is taken out of the plastic casing, and the 
screen inside the shielding is the same depth as the 
Lack coffee table. “This means that once you’ve got 
the screen, all youmeed IG. dois dhopaiG Imo Ene Mole 
[you cut],” says Spanner. 


SPANNER SPENCER 


Spanner is the community 
manager for Element14, 
an online community 

for engineers. 
magpi.cc/1qODxb9 


Asquare in 
the table is 
cut to contain 
the 17-inch 
display. The 
wood is then 
prised out 

to reveal the 
structural 
filling inside 


Holes drilled 
into the 
surface 
house the 
joystick and 
buttons. The 
controls are 
inserted from 
underneath 


controls are 
connected to 
an Arduino 
Leonardo, 
which 
translates the 
movement 

to keyboard 
commands 


and sends 
them to the 
Raspberry Pi 


There are clear instructions for joysticks and buttons on 
Element 14’s website (magpi.cc/1qOxwLG). “Drill 28mm 
holes for each one,” says Spanner. “This is the standard 
size for arcade buttons, and also gives the joystick plenty 
of room to move without the hole being visible around 
the round, flat cover that comes with the joystick.” 

The PIK3A uses an Arduino Leonardo 
(magpi.cc/1qOxyTQ) to interface the controls with 
the Raspberry Pi. It’s an interesting way to hook 
up the controls, and a lot easier than other 
implementations we’ve seen. 
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TEN AMAZING ARCADE MACHINE PROJECTS | feature 


ARCADE | | LEGEND OF ZELDA 
Looking for the perfect scale arcade machine? | \ g BARTOP 


Look no further y ie ea There are lots of bartop 
Bis eeu : projects around, but 
We featured Tiburcio de la . || < == ee} this Legend Of Zelda 


Carcova’s Galaga Pi project in We Gin i a (magpi.cc/1qOD3Ix) is 
issue 44, but we couldn’t doa a! ea 14 one of the prettiest. “I’ve 
feature on our favourite arcade \ 1 en = Bo) 4 a always wanted my arcade 
projects and not mention | Gt SS PS cabinet,” says Phrazelle. 
the Mini Arcade. “- < “T’m glad I did because 

Tiburcio’s miniature arcade * “~ ; the final build exceeded 
machine reproductions (of | jas my expectations by far.” 
which Galaga is just the latest) 
remain the gold standard for 
scale reproductions (they even 
have small coin slots). Hand- 
built from plywood and acrylic, 
and with as many 3D-printed 
parts as possible, they area 
labour of love. Reproduction is 
probably beyond all but the most 
dedicated of makers, but Tiburcio takes us through the build of Galaga 
on his YouTube channel (magpi.cc/1V8XEvY) 

So far he’s built perfect reproductions of Space Invaders, Pac-Man, and 
Galaga, with more to come. They’re the most inspirational builds around. 


ARCADE " COFFEE TABLE PI 


Graham Gelding’s Coffee Table Pi (magpi.cc/1qODcFy) 


This bare-bones arcade project is one of the neatest arcade tables around. It also 
: ™ : _ hasa huge 24-inch LCD screen and is sturdy and 
Ber BEIGE Se and great value child-friendly (with rounded corners and Perspex 
mounted over the screen). 


BUBBLE BOBBLE 


Arcade Pi is alone in our list of favourite arcade machines in that it 
isn’t acomplete build. Instead, it packs the Raspberry Pi inside a 
wooden base containing the arcade stick and buttons. 

We think the Arcade Pi (magpi.cc/1Q5gGw§8) is a great option for 
those looking to build an arcade machine, but not having the space, or 


money, for a full cabinet build. “I’ve always dreamed of having an arcade We just adore aor: . 
machine,” says creator Sacha. “Man, it takes a lot of space, and it’s _ Christopher Sadler’s 
expensive. I arrived at the conclusion that I had to build one myself.” _ Bubble Bobble bartop 
| This project enables you to experiment with arcade joysticks and - arcade machine 
ho™ _ buttons and build a working arcade console in a much smaller space, (magpi.cc/1VwzpsM), if 
and for a much lower price. ee ee ee for no other reason than 


: , its lovely decals. “All my 
Like all great ——— i Xi plans were based around 
arcade sticks, you baal | : : 

SROUlchdeanitely , : wanting to Hak artwork 
customise Rae late. 27 of) _ from my favourite game 
the faceipiate (— Jer a es ever: Bubble Bobble,” 
yourself j : a =e ‘ aa ; 

says Christopher. 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


ca 


Your technical hardware and software problems solved... 


PI CAMERA MODULE V2 
eee ee 


Rospherry—Pi 


j KCL OF 18 
Comera V2.1 wrk Beans 


ae 
SN 
x a\\ 
‘ ' -ih--DIME As 
The RAW function : aves 
The raspistillyuv command is a much more ehh a 3 
advanced option than raspistill, as it creates a RAW > 8 


file. These can be edited using specific software, to 
take into account white balance and other colour levels 
much better than in a compressed JPG or PNG. You’11 
need to do this on another computer, though. 
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The time-lapse option 

The option --timelapse when taking a photo can 
be used to create time-lapse photography - it’s a 
massively popular thing to do with the camera, so 
being part of the software makes it easy. Set a time 


Online 

You can easily upload the photos to your social media or 
cloud storage accounts via the web browser, either for 
safekeeping or to show them off. The files are normal 
image files, so will be recognised by any online service 


with -t for the desired duration of the time-lapse, to upload or post. 
then set intervals with the time-lapse option. 

The option --keypress will allow you to take photos 

when you press the ENTER key for however long you’ve On the Pi 


TZ 
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set the time for. If you give a time of 0, it will run 
indefinitely until you press X then ENTER. A slightly 
different way of shooting with the camera! 


On the Pi 

The Raspberry Pi comes with an image viewer that 
allows you to just open and view the photos you’ve 
taken. This works a little better on Raspberry Pi 2 
and Pi3, especially when you’re using the maximum 
resolution of the camera for photos! 


On a computer 

You can easily plug an SD card into a PC or Mac and 
view the files on there. They’1l be in the home folder, 
which can be found by going to home, then pion the 
file system. Copy them off to make sure you don’t 
lose them. 


The Raspberry Pi, by default, has a video player called 
omxplayer, which you can access via the command 
line. While it does have a number of options, you can 
simply use omxplayer [filename] to play a file at 
maximum resolution. 


On a computer 

Alternatively, you can just grab the SD card from the 
Raspberry Pi and plug it into your PC. A video player 
like VLC will easily play the videos recorded on the 
Raspberry Pi camera — but remember, you won’t have 
any sound in the file! 


Playing slow-motion video 

Not all the players will automatically play slow-mo 
video at slow-mo speed. At normal speed, it will play 
a real-time video with a very smooth frame rate, but 
with VLC you can turn down the playback speed to get 
the true slow-mo effect. Most video editors will let 
you slow down the video as well. 
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What is the default user name and password for the 
Raspberry Pi? 

The default user name for Raspbian is ‘pi’ (without any 
quotation marks) and the default password is ‘raspberry’ 
(again, don't include the quotation marks). If this doesn't 
work, check the information about your specific distro on 
the downloads page. 


Where is the on/off switch on the Raspberry Pi? 

There is no on/off switch! To switch on, just plug it in. To 
switch off, open the top-left menu in the Raspbian GUI and 
click Shutdown at the bottom, then press OK. Alternatively, 
from the Bash prompt or a terminal, enter sudo halt -h 
to shut it down. Wait until all the LEDs except the power 


LED are off, then wait an additional second to make sure the 


SD card can finish its wear levelling tasks and write actions. 


You can now Safely unplug the Raspberry Pi. Failure to properly 
shut down the Raspberry Pi may corrupt your SD card, which 
would mean you would have to re-image it. 


Why does nothing happen when | type in my password? 

Did my Raspberry Pi freeze? 

Don't worry, it’s still working. To protect your information, Linux 
doesn't display anything when typing in passwords in the Bash 
prompt or the terminal. 


How do! connect a mouse and keyboard? 

The Model A/A+ has one USB port, the Model B has two ports, 
and the Model B+, 2B and 3B have four ports. These can be 
used to connect most USB 2.0 devices. Additional USB devices 
such as mice, keyboards, network adapters, and external 
storage can be connected via a USB hub. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 


How do | find The MagPi on Google Play 
or the App Store? 


All you have to do is go to the search bar and type ‘The MagPi 


or ‘Raspberry Pi' to find us. 


I've subscribed to the digital edition and | can't sign 
in to restore my purchases. Please help! 


Since your The MagPi purchases are linked to your Google or Apple 


accounts, there's no need to sign in at all. If you'd like to re-download 


your purchases on your current device, or make your purchases 


available on other devices, all you need to do is press ‘Subscribe’ 


on the home screen, then ‘Restore Purchases’ on the next screen. 


How can | search the digital magazine for keywords? 


GET IT ON 


>» Google Play 


Finding direct references is really easy with The MagPi app: all you 


have to do is tap the screen to get the app's GUI to show, and then a 
press the small magnifying glass icon in the top-right corner of the 
screen. Just type in your search term to find the relevant results. 


raspberrypi.org/magpi 


Available on the 


§ App Store 
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Waker 
says 


Raspberry 
Pj drum-kit 
that lets 
your fingers 
think they're 
Stubblefield 


Pimoroni 


PIANO HAT 


The Piano 

HAT is more 
detailed, with 16 
touch-sensitive 
buttons (forming 
13 piano keys). 
You can use 

the Piano HAT 
and Drum HAT 
together using 

a Black HAT 
Hack3r device. 


£15 / $21 
magpi.cc/10ALWNT 
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DRUM HAT 


Hot on the heels of Pimoroni’s successful Piano HAT comes this hot 
drum machine. Discover the joy of code-based finger drumming 


while ago we came across 
the Piano HAT, a snazzy 
piece of hardware based 
on Zachary Igielman’s PiPiano and 
turned into a HAT (hardware on 
top) device by Pimoroni. 

The Drum HAT is its funky 
brother, capable of quickly 
transforming a Raspberry Pi into 
a drum machine. On top of the 
board sit eight capacitive sensor 
pads; you tap the beat out with 
your fingers. Each pad also sports 
an LED that lights up when you tap 


(or can be programmed separately). 


Installation is easy thanks 
to acommand listed on the 
Drum HAT’s GitHub page 
(magpi.cc/1VwzZWb). Just enter 
curl -sS get.pimoroni.com/ 
drumhat | bash to get started. 
This script installs the Python 
modules and downloads a bunch 


of sample WAV files and programs 
Enter python drums. py and you’ll 
quickly have a drum machine ready 
to play. A file called direct.py 

links the samples in the drums2 
folder, and you can edit the 

Python code to link to any folder 
you want. Then it’s just a case of 
creating some drum samples, or 
downloading sample files from 

a site like looperman.com. 


Amen to that 

We started by recreating ‘Boots 

and Cats’ (youtu.be/NniorTLg5B8 ) 

using our sampled voices, 

then grabbed a bunch of 

samples of the ‘Amen Break’ 

(youtu.be/5SaFTm2bcac) and set 

to turning a Raspberry Pi into a 

kick-ass drum-and-bass machine. 
Taking apart the sample code 

(and reading the GitHub page) 


enabled us to figure out the 
Drum HAT code. You can set 
the pads to react when hit, or 
released, and you can get the 
pads to call a function that can 
do anything. 

Building a drum machine is 
where it’s at, though, and we had 
an awesome amount of fun with 
the Drum HAT (much more than 
with the seemingly more complex 
Piano HAT). A good project 
to try out. 


fast word 


Easy to set up and fun to bash 
around on, the Drum HAT turns 


a Raspberry Pi into a home- 
made 808 drum machine. 
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Electronics Starter Kit 
for Raspberry PI 


This kit contains everything you need (apart from 
a Raspberry Pi) to create ten electronic projects. 


° 10 easy to follow project cards ¢ Compatible with Pi B, B+, A+, Pi 2 

. . buzzer, light sensor, temperature sensor, 
° 20 jumper wires and capacitor 
° All Python code in one easy download * No soldering required 


RasPiRobot Board v3 


A simple to use motor controller for the Raspberry 


Pi. This board is designed to simplify the process £17.50 / 

of making small roving robots and controlling $25 - $29.95 

medium power loads using a Raspberry Pi. 

¢ Dual bi-directional motor control using ¢ 2 x user controllable LEDs 
TB6612FNG dual H-bridge ¢ 2 x header pins for switches 

¢ Dual open drain 2A MOSFET outputs ° Reverse polarity protection 

° Socket for HC-SRO4 Rangefinder * Open Source Python Software library 

¢ Socket for 5V I2C Interface ¢ Screw terminals for motor 

° Provides regulated power and power connections 
to Raspberry Pi ¢ Compatible with Pi, B+, A+, Pi2 


Please note: Illustration of possible use only, chassis, Raspberry Pi, motors, rangefinder etc. not included 


Raspberry Squid Combo Pack 


Using the included Raspberry Leaf GPIO template, attach an 
RGB LED and push buttons directly to the GPIO pins of a 
Raspberry Pi. The switches are panel-mountable and perfect 
when putting your Raspberry Pi project into an enclosure. 


° Includes one RGB LED Sauid and two Squid Buttons and a Raspberry Leaf GPIO template 
¢ RGB LED and switches plug directly into Raspberry Pi GPIO pins 


¢ Simple to use Python library for RGB LED control and switch debouncing 


amazoncom amazon.co.uk 


Enter promo code: MAGPINOW 


www.monkmakes.com | twitter@monkmakes 


RASPI 
ROBOT 
BOARD V3 


Create slightly 
different robots 


with this board 
that allows 
access to all the 


GPIO pins for 
more manual 
construction. 


magpi.cc/1VBwoYG 
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A new robotics board from 4tronix that fits snugly on your Pi Zero 
for some miniature robotics 


i Zero robots are quickly 

becoming popular. This 

was inevitable, given the 
nature of the Pi community and just 
how useful the Zero can be in sucha 
situation. We’ve already got a new kit 
from the folks over at PiBorg coming 
soon after a successful Kickstarter, 
and plenty of little projects and 
builds that use it for diminutive 
automatons. Usually, these small 
robots use pre-existing small motor- 
controllers. However, we now also 
have the Picon Zero from Pi robot 
veterans 4tronix. 

Its claim to fame is that it’s a 
robot control board with the same 
size/form-—factor as the Pi Zero. This 
means it slots right on top of a Pi 
Zero without poking over any of the 
edges. This is particularly handy, 


as it allows you to easily access the 
ports and SD card and such. It also 
means that you’ll need to have a set 
of GPIO pins soldered onto the Pi 
Zero, which is really not a massive 
ordeal, although we know the idea of 
it is still a little scary for some. 

It’s certainly worth it, as the Picon 
Zero comes with a huge amount 
of benefits for robot building with 
the Pi. As you might expect, it can 
power two motors; unusually for 
a motorboard, it can draw power 
directly from the Raspberry Pi for 
this. This uses 5V, which the Pi can 
provide but which it is rarely used 
for due to the power draw. With two 
small motors, it’s not so high; if it’s 
a little too much for the Pi, however, 
the Picon can also take USB power. 
This can be a little easier to hook 


up and maintain than rechargeable 
batteries, so it’s aneat addition. 


The ins and outs 

One of the best things about the 
board is the numbers of inputs and 
outputs it supports, especially for 
its size. Dotted around the PCB 

are inputs that accept digital and 
analogue signals, as well as having 
the ability to be configured to use 
popular temperature and humidity 
sensors. Output-wise, it’s also fairly 
powerful, with configurations to 
allow digital output, the ability to use 
PWM, standard servo controls, and 
even NeoPixel support. 

This is amazing for such a small 
device. Some full-size HATs or 
controllers for the Pi can handle 
motors and a HC-SRo<g ultrasonic 
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sensor input (which, by the way, the 
Picon also has a dedicated input for), 
but then you still might have to play 
around with some GPIOs to get the 
rest working. The Picon is incredibly 
comprehensive; it even opens up a 
small section of the GPIO port with 
five GPIO pins and a selection of 
Ground, 3V3, and 5V pins. 


that are very simple to program if 
you have a cursory understanding 
of Python. There are also some 
worksheets for teaching the ins and 
outs of using the library; at the time 
of writing, however, they only get 
so far as to teach you how to read 
the input of a reed switch, and cover 
nothing to do with motors. 


One of the best things about 
the board 1s the number of 
inputs and outputs 1t supports 


Code it 


The whole system is powered by 

a Python library custom-made by 
4tronix. It’s incredibly simple to 
install, simply requiring you to 
download a script that will do all the 
work. It comes with some example 
Python scripts and the modules 
needed to operate the board with 
your own custom scripts. A full 
breakdown of the features can be 
found on the 4tronix blog for the 
Picon Zero (magpi.cc/1SMc8N8), but 
there’s a huge number of functions 
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They’ re likely to be on their way 
very soon and you shouldn't be 
discouraged by that, as reading 
up on the functions and looking 
over the test and example code 
that comes with the Picon libraries 
should be enough to get you making 
full use of the Picon. 

The only real issue we have with 
the Picon is that things can geta 
little tight on the board if you’re 
using a significant number of inputs 
and outputs, although that’s the 
price you pay for it all being in 


| 


= | zy nN a q E 7 ] 3] ~* a=, 
PICON ZERO 


Waker 
days 


Intelligent 
robotic 
controller for 
Raspberry Pi 


Atronix 


Left The board 
sits well above 
the Pi Zero, but 
not so high that 
it significantly 
decreases 
space efficiency 


such a small space. It does fit ona 
regular Raspberry Pi as well, so for 
the price it may well be something 
you could consider for any type of Pi 
robot project. 

It’s certainly one of the most 
comprehensive robot HATs we’ve 
come across for the Pi, and that low 
price makes it pretty special as well. 
Absolutely worth a look if you’re 
wanting to make a more complex 
machine for your robotic needs. 


Above An 
ultrasonic sensor 


can plug straight 
into the board if 
you want to keep 
things compact 


fast word 


Awonderful robot controller at 
an amazingly low price. While 


designed for the Pi Zero, it can 
be used on any Raspberry Pi. 
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Maker 
says 
Like a 
Web Control 
Panel on 
Steroids 
- lots of 


Steroids 
Wyliodrin 


WYLIODRIN STUDIO 


This Chrome App development tool makes it easy to create 
Internet of Things projects on your Raspberry Pi 


yliodrin STUDIO is a 
Chrome App development 
suite that enables 
developers to take a board, like our 
beloved Raspberry Pi, and quickly 
prototype an IoT device. 

Setup is a breeze: installation is 
via disk image and from that point 
on, everything takes place from 
Chrome on another computer. You 
can still use the Wyliodrin website 


accelerometers. There are blocks 
for GoPiGo, Lego Mindstorms, and 
Grove sensors. You can even set up 
a web server using blocks. 

The blocks are converted to 
Python code on the fly, and you 
can move back and forth between 
Visual Programming and Python. 

It’s easy to be sniffy about using 
blocks when you’ve taken the 
time to learn Python or Java, but 


some powerful tutorials to follow. 
Wyliodrin STUDIO doesn’t have 
the limitations of the browser- 
based service, and you can add 
as many projects and Dashboard 
widgets as you want. Note that 
the contract states that it’s for 
personal and educational use only. 
We’re impressed with Wyliodrin 
STUDIO. It’s a solid IDE that’s 
easy to set up, with no real 


(projects.wyliodrin.com), which it’s impossible to make a syntax restrictions. Visual Programming 


WINDOWS has new features, but what we’re error. Therefore, you can focus is a great way to demystify the 
10 10T really interested inis the Wyliodrin _ on the logic, and we find slotting often enigmatic nature of IoT 
angel STUDIO Chrome Web Store app blocks together a fun way to get prototyping, and there are some 
completely (magpi.cc/23swO80). inspiration. There are limitations ereat tutorials available. 

different, but ; (it doesn’t scale up particularly 

pelea Got a visual well), but you can always move your fast word 

rival platform Wyliodrin supports JavaScript and project over to Python. 

targeting the Python, but the entry point is Visual A eet! springboard to start 
same developer Programming, a beefed-up version In a dash Sulla chaos In Srna seeeee 
community. projects. Visual Programming 


magpi.cc/1qOEEb1 


of Google’s Blockly. Programs are 
arranged, like Scratch, by dragging 
and dropping blocks together. 

It?s much more powerful than 
either Scratch or Blockly, with 
blocks for everything from social 
media to humidity sensors and 


The other side of Wyliodrin is the 
Dashboard, which features an array 
of graphs, charts, dials, buttons, 
and sliders — everything you need 
to visually interact with your 
Raspberry Pi. There is a great range 
of example programs included, and 


is a fun way to get started, but 


you're not limited in scope. The 
Dashboard brings your projects 
to life with buttons and dials. 
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NUCLEUS ZERO PI ZERO CASE 


Waker 
days 


This eye- 
catching case 
is Sure to get 
your friends’ 


attention 
C4 Labs 


NUCLEUS ZERO 
PI ZERO CASE 


A case completely made of wood for the Raspberry Pi - 
it’s absolutely not a fire hazard 


ZEBRA 
ZERO CASE 


Still slightly 
wooden, also 
with a plastic 
alternative, the 
Zebra Zero is 
slightly better 
for projects that 
need access 

to the GPIO, 
while still being 
a good case 
for the rest 

of the Zero. 


he Zebra Zero case we 
reviewed a couple of issues 
ago made quite a splash 
when it was first unveiled. Having 
wooden parts is still fairly unusual 
for Raspberry Pi cases, although 
the Zebra Zero is wooden (albeit 
with a plastic centre). This C4 
Labs case, though, is completely 
wooden, through and through. 
We reckon the screws are metal, 
but it even comes with wooden 
Spacers. Very cool. 

The design is very funky, with 
lots of asymmetrical cuts in the 


“», material that give an effect of 
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naturally grown wood, but also 
allow for some airflow to the chips 
on the board. Very clever. There’s 
easy access to the three main ports 
on the side; in fact, the way the 
wood is cut for these ports and 


the SD card slot, it’s pretty easy 

to figure out how it’s meant to be 
constructed. It’s only three pieces, 
after all. 

Access to the SD card is a little 
tricky compared to the bare board, 
and you’ll curse cutting your 
nails short if you’re in the habit 
of taking the card out regularly. 
Not everyone needs to do this 
often, though, and it’s still quite 
possible. One thing unique about 
the Nucleus is that the GPIO holes 
are completely covered up by the 
case. For some this won’t bea 
problem, and it’s nice that this is 
an option if you don’t plan to use 
them. There are plenty of other 
cases out there that open up the 
GPIO, such as the aforementioned 
Zebra Zero, SO we’re not too 
bothered about it. In fact, 


we like it as an alternative for 
certain Pi Zero projects. 

This is a pretty sturdy and very 
protective case for the Zero, then. 
It’s nice and cheap, too, especially 
as it’s made of quite nice-looking 
wood (it’s still laser-cut, of 
course). Really, it’s just an eye- 
catching case and if a full-coverage 
case is what you’re looking for, 
then maybe it’s the one for you. 


fast word 


Anice alternative case, 
whether for the wooden 
construction or for the full 


coverage of the Pi Zero. It’s 
well designed, while still 
looking great. 
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RASPBERRY PI 
BESTSELLERS 


Improve your handling of computational 
problems with a thorough grounding 
in algorithms 


THE 
ALGORITHM 
DESIGN MANUAL 


Author: Steven S Skiena 
Publisher: Springer 
Price: £55.07 

ISBN: 978-1848000698 
magpi.cc/1VDJchi 


Skiena tackles algorithms with reve 5 = 
an engineer's mindset; lacking Boer 
the mathematical rigour (and 
page count) of the MIT Press 
book (see below), it wins out on 
real-world examples, making a 


most practical introduction. 


INTRODUCTIONTO =—— 
ALGORITHMS - , 


Authors: Thomas H Cormen, th, 
Charles E Leiserson, | 


Clifford Stein & Ronald L Rivest | ° | 


Publisher: MIT Press 
Price: £44.95 | 
ISBN: 978-0262533058 \ 
magpi.cc/1VDJt3l 


Perhaps the definitive reference 
work and tutorial on algorithms, 
but you'll need a good grasp of 
mathematics, as well as some 
programming experience, 

to get the most out of it. 


ALGORITHMS 


Authors: Robert Sedgewick 
& Kevin Wayne 

Publisher: Addison Wesley 
Price: £55.99 

ISBN: 978-0321573513 
magpi.cc/1VDJrch 


Sedgewick’s popular book 

- which has its own two- 

part Coursera MOOC - has 
clear explanations and 
diagrams, and useful Java 
implementations which should 
translate to your preferred 
language (but check errata). 


MagPi May 2015 


SAMS TEACH 


YOURSELF PY THU 
PROGRAMMING FOR 
RASPBERRY PIIN 24 HRS 
— 

Author: Richard Blum | oo 
& Christine Bresnahan Python” 

ublisher: n 
a vs | : rogrammin 


or Raspberry Pj 


ISBN: 978-0672337642 
magpi.cc/1VDJyV6 


“Making Python 
the official programming 

language of the popular Raspberry 
Pi was genius,” write the authors 
in the introduction. Some measure 
of astuteness must also be ascribed 
to Pearson’s Sams imprint for 
realising a couple of dozen tutorial 
chapters of typical length made 
the equivalent of a day - albeit a 
somewhat demanding one — and 
creating the ‘Teach Yourself ... 

in 24 Hours’ series. Now Blum 

and Bresnehan, both experienced 
sysadmins, have updated and 
revised their fine introduction to 
programming in Python on the Pi. 


BEGINNING THE 
LINUX COMMAND 
LINE 


Author: Sander van Vugt 
Publisher: Apress 

Price: £26.50 

ISBN: 978-1430268307 
magpi.cc/1VDJPHL 


Every user of 
Raspbian, or any 
other GNU/Linux 
distribution, becomes in a small 
way a systems administrator. Most 
tasks are best accomplished via 
the command line, and van Vugt’s 
excellent introduction is very much 
aimed at practical administration, 
whether the reader has a Pi, a 
server they’re programming, 
or they’re a Windows sysadmin 
taking on Linux tasks. 

Providing plenty of background 
along the way — which should 
help new users understand the 
‘why’ along with the ‘how’ of the 
command line — the author starts 
with several practical commands 


Aimed squarely at those new 
to both Python and Pi, the first 
three ‘hours’ cover setup for both. 

That done, the next four hours 

are spent on programming 

fundamentals, building simple 

scripts, then advancing to logic 
flow control. Useful introductions 
along the way include the NumPy 
module, iterating over lists, and 
dealing with errors. 

A ten-hour chunk of ‘Advanced 
Python’ covers topics like lists 
and tuples, creating functions, and 
object-oriented programming, as 
well as exception handling and an 
introduction to regular expressions. 
Next is GUI programming with 
Tkinter and Pygame, “business 
programming’ (network, database, 
and web server), and multimedia 
and GPIO projects round off a very 
useful guide. Recommended for any 
beginner with 24 hours to spare. 


which give the user useful control 
of her system, with users, files, 
and disks all covered well 
in the first three chapters. 
The chapter on working 
with text files starts with 
mastering vi - the one 
editor found on all Unix 
computers. Further chapters 
are usefully task-oriented. 
Steering a middle path 
between quick introduction 
and comprehensive 
reference, Beginning the Linux 
Command Line gives the reader 
practical information without 
overwhelming with detail, yet 
still fills in background where 
context is necessary for real 
understanding. The final chapter, 
on Shell scripting, is a good 
example of the author’s well- 
paced tutorial approach, and leaves 
the reader prepared for tackling 
many admin tasks. 
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RASPBERRY PI 
NETWORKING 
COOKBOOK 


Author: Rick Golden 
Publisher: Packt 
Price: £28.99 

ISBN: 978-1785280214 


R 
magpi.cc/1VDKs3U ae euel 


Cook book 


Second Edition 


Despite some 
bottlenecks in 
networking through Ethernet and 
USB-connected network interfaces, 
the Pi 2 is, as Golden points out in 
his preface, every bit as powerful 
as a network server from the late 
1990s. This being so, despite 20 
years of Moore’s Law growth for 
modern network servers, the 
Pi 2 (and now the Pi 3) can be 
used for many network tasks to 
“share files, host websites, create 
internet access points, and analyse 
network traffic.” 

With chapters collecting recipes 
both by theme and by difficulty, 
there are entry points in this work 


ADAPTIVE 
WEB DESIGN 


Author: Aaron Gustafson 
Publisher: New Riders 
Price: £21.99 

ISBN: 978-0134216140 
adaptivewebdesign.info 


ADAPTIVE 
It’s a full house of 
second editions 
this month, and 
Gustafson’s is a 
welcome update to this high-level 
yet practical guide to the why and 
how of adaptive web design. The 
approach here is more than adding 
responsive design for mobile 
browsers. Progressive enhancement 
is the mantra, building site features 
on a foundation of content that’s 
accessible to all browsers and users. 
From GitHub.io project pages 
to WordPress blogs, it’s almost 
inevitable that makers end up 
responsible for websites, and thus 
for web design, so this could be 


raspberrypi.org/magpi 


Pi Networking 


WEB DESIGN @ 


for beginner and intermediate 
users. The early chapters also 
include enough information on 
setup, system administration, and 
maintenance, to enable 
those new to the GNU/ 
Linux command line 


Recipes for file sharing 
enable you set up the Pi 
as a network file server 
for home or office. The 

Advanced Networking 
chapter covers firewalls, 
web servers and wikis, wireless 
access points, and network 
analysis tools. Internet of Things 
goes from GPIO setup, through 
GrovePi, to web. py and controlling 
devices through a webpage. 

Lastly, there’s computing over 

the network with clustering — 

and setting up your own Raspberry 
Pi “supercomputer”. A valuable 
introduction and reference. 


Score 


the book to make you think more 
seriously about the subject. Aimed 
at developers, project managers, 
and web professionals, 
it’s broad enough to be 
approachable for all, yet deep 
enough to leave you witha 
practical idea of what needs to 
be done to make your site(s) 
a pleasant and informative 
experience for all visitors. 
Gustafson starts squarely 
with content — sadly an 
afterthought for many 
designers, but the only thing 
everyone needs from a site. 
Markup, visual styling, and 
interactions are then added to 
a common base of universally 
accessible content, ensuring each 
user gets the best site for her 
browser, device, and screen size. 
Practical, thoughtful, and a good 
read, too. 


Score 


ESSENTIAL READING: 
ROBOT BUILDING 


Classics and recent releases to help you get your 
robotic project moving 


Raspberry Pi 

Robotics Essentials = | 
“a 

Author: Richard Grimmett c Se o. 

Publisher: Packt Ls, a 

Price: £19.99 wa Pome 


ISBN: 978-1785284847 
magpi.cc/1VDKDw8 


Build a walking robot and add six 
degrees of freedom, plus sensors, 
vision, and path planning. 


Motors for Makers 


Author: Matthew Scarpino 
Publisher: Que 

Price: £21.99 

ISBN: 978-0134032832 
motorsformakers.com 


TORS 
MI MAKERS 


eid NA 
ale 
~ 


4 
Detailed and practical guide to using Q 
motors with the Pi and other boards, 
with code and vehicle projects. 


Robot Operating System (ROS): 
The Complete Reference 


Author: Anis Koubaa (Editor) 
Publisher: Springer 

Price: £149.00 

ISBN: 978-3319260525 
magpi.cc/1VDKR6k 


Operating 
System (ROS) 


27 chapters, both practical and 
academic, giving comprehensive 
coverage of open-source middleware 
for autonomous robots. 


OpenCV with Python 
By Example 


Author: Prateek Joshi 
Publisher: Packt 
Price: £31.99 

ISBN: 978-1785283932 
magpi.cc/1VDKVmE 


OpenCV with Python 
By Example 
Well-regarded guide to the practical 
side of computer vision algorithms, that 
enables the reader to understand the 
problems - and solutions. 


| Robot 


Author: Isaac Asimov 
Publisher: Harper Voyager 
Price: £7.99 

ISBN: 978-0007532278 
magpi.cc/1VDLouf 


Robots that think like us are still 
science fiction, but Asimov's pioneering 
stories ask essential philosophical (and 
relevant) questions. 
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THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


RASPBERRY PIS 


ver the last month, we’ve seen some amazing little 

projects that have made use of the Raspberry Pi 

for gaming, or just fitting one inside an old games 
console for the fun of it. It comes just in time as well; the 
software that usually powers all of this, RetroPie, has 
recently been updated to 3.6, and has a new beginner’s 
guide for people getting their new Pi 3s. Here are some of RETRO GAM ES | N AN U B E R 


the best gaming-based projects we’ve seen this month... 


magpi.cc/1SYOBsG 


We like the idea of this, as sometimes you can have 
some really awkward conversations with a cabbie. It’s 
not their fault: some people like to socialise. An easy 
way to find common ground for a chat, though, is a 
mixture of making and retro gaming, which is why 
dantheflipman on Reddit was proud to show off the 
Pi-powered retro gaming system in his own Uber. We 
like its simplicity - a SNES pad and a screen. That can 
get you through a lot of very good video games. 


Nintendo GAME BOY... 


-— @& 
. 
F.S. 


- : _ ¥ . 
oad “« \\ q 


—___—_ 


GAME BOY ZERO 


imgur.com/a/jyjmG 


This is a really cool one: Wermy has completely hacked 
an original Game Boy to be a portable retro-gaming 


machine. Well, the Game Boy was already one of those, 
but it couldn’t play SNES games, and this one can. DS-SIZED POCKET COM PUTER 


Powered by a Raspberry Pi Zero and with extra buttons 


added to handle more demanding titles, the Game pte rer eats 

Boy Zero is quite the feat of engineering. The SD card Made using off-the-shelf parts, this little computer 
actually resides in a standard Game Boy cartridge, which acts like some of those other Nintendo DS-sized mini 
needs to be plugged in so the Pi can actually have an PCs you see on eBay for retro gaming. This one is a bit 
operating system. It has incredible attention to detail, cooler, though, as it uses a Raspberry Pi. It’s made as 
and adds to the masses of great ‘Pi Zeroinasmall games a fully functioning Linux computer, although it did 
thing’ projects that have been appearing in the last few require a fair bit of hacking (especially removing some 
months. You can also check out a video of it all working bits from the Pi itself). It uses Raspbian to work, and it 
on YouTube: youtu.be/aMhTMgDHGaM does fold up like a DS as well. 
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THIS MONTH IN PI QQ iy 


CROWDFUND 
THIS! 


The best crowdfunding hits this 
month for you to check out... 


The FUZEBOX - get more from those costly devices and be 


sure your kids are learning valuable skills for the future. 


FlUlZ[e, 
BTAls{ifc 


OT HAT FOR RASPBERRY PI 
pete 


While the Raspberry Pi 3 is pretty amazing, in no small 
part due to its built-in wireless LAN and Bluetooth, 
these features are not on the older Raspberry Pi. Sure, 
a lot of people have been using dongles, but here’s a 
project for a HAT with the same dimensions as the 
2 UJ 7 E 7 0) X Pi Zero, that will allow for WiFi and Bluetooth on the 
Zero, and any other Pi that doesn’t have it already. It’s 
| kekst/2ztvssm being marketed as a great thing for IoT projects, and 
it’s already passed its funding goal, so give it a look. 
FUZE makes a device very much like the BBC Micro 
of old, but this one is powered by a Raspberry Pi, and 
has room for doing all sorts of physical computing 3 E S T O F TH E R E S T 
and tinkering. Now the FUZE team are making the 
FUZEBOX, a device that connects (with a wire or 
wirelessly!) to a Raspberry Pi and other computers, 
So you can do some coding and physical computing 


on anything you own. It still needs some money to be 
funded, though, and could use your help! 


HOME-MADE LAPTOP 


imgur.com/a/vRqhH 


RASPBERRY PI 
SPRINKLER SYSTEM 


imgur.com/a/9ibFf ] a 
5 | a Hl 


RASPBERRY PI AIO SHIELD 


| magplce/sqVEpKe aqYEpKe 


A new shield idea for the Raspberry Pi that allows 

for both analogue-to-digital conversion (ADC) and 
digital-to-analogue conversion (DAC), as well as 24-bit 
PWM support. It’s not had much interest yet, but if 
you’ re willing to take a punt you could come away with 
an interesting little add-on for the Raspberry Pi that 
gives it some extra features. Great for making slightly 
more complex projects, if that’s your thing. 
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The Pi camera 
module is 
protected by 

a clear plastic 
window, custom- 
cut using a router 


Sota iing MeeLeucea tena) geese EQ UNee ft hme 2 creatine 


keen scuba diver and 

RC model maker, Niels 

Affourtit had always 
been fascinated by the possibility 
of building a remote-control 
submarine, but was deterred due 
to the expense and the potential 
for leakages. When he saw footage 
of a VideoRay underwater ROV 
(remotely operated vehicle) in 
2014, however, his enthusiasm was 
rekindled and he set out to see if it 
was feasible to build a video ROV of 
his own (magpi.cc/20TfFIiE). 

“When I started Googling, it 

was the first time I read about the 
Raspberry Pi,” Niels tells us. “When 
I found out that the Pi can control 
servos and ESCs (electronic speed 
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Diagnostics 


Tite © t Ow Sy 
Mien brs 


<a 


RSIB 


Rather than taking to the skies like 
most Pi-powered drones, this ingenious 
ROV dives beneath the surface for some 
underwater exploration 


controllers) directly via PWM, has 
the option for a camera, and has a 
low power consumption, I realised it 
was a perfect platform for my ROV.” 
Naturally, a waterproof hull 
would also be required. Niels 
constructed his in just 15 hours 
using PVCu, similar to drainpipe 
material. Indeed, the closure is a 
standard connection for pressure 
piping, while Niels cut out its 
transparent screen with a router. 
The use of brushless motors also 
helped greatly: “Since the motors 
are running in water, there are no 
moving parts through the hull and 
leakage is almost impossible.” 
The only parts that pass through 
the hull are wires for the motors, 


Constructed 
from PVCu, the 
hull provides a 
waterproof case 
for the Pi and 
other electronic 
components 


Live video and sensor data 
are viewed on a tethered 
laptop; a standard joystick 
is used for steering 


lights, echosounder, depth 
and temperature sensors, and 
communication with a laptop. 
Since high-frequency wireless 
signals can’t penetrate water, 
while low-frequency ones are too 
Slow to send live video, the ROV 
is tethered to its laptop controller 
via a long cable. “From OpenROV 
(openrov.com), I learned to 
modify a specific Ethernmet-over— 
power adaptor, which reduces the 
standard four-wire patch cable to 
only two and makes the wire very 
insensitive to interference and bad 
connections. The cable is now 100 
metres long, but the maximum 
reach of the adaptors is in the 
order of 300m.” 
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3D-printed parts 
For the propellers and Pi camera 
tilt system, Niels drafted designs in 
AutoCAD and 3D-printed them with 
an Inno3D printer borrowed from a 
neighbour. “I have experience in 3D 
drawing via my work [as an engineer 
for offshore pipelines], so that 
is an advantage.” 

Niels’s background in mechanical 
engineering also came in useful 
for assembling the electrical 
components, as did his experience 
with Python and Linux machines 
for programming the sensors. Even 
so, he found the process a real 
challenge, taking around 200 hours 


Every step 1n the design, you 
search for solutions and you 


the Pi camera up and down. All the 
sensors are connected via PC, except 
the depth sensor and MaxBotix 
echosounder (to determine the 
height above the seabed). “For 
these, I attached an Arduino via USB 
to the Pi.” 


Plumbing the depths 

To take depth readings, Niels’s 
original design featured a standard 
diving computer suspended in front of 
the ROV, to be viewed by the camera, 
but he has since added an inexpensive 
depth sensor. After testing the ROV 

in aswimming pool, Niels has taken 

it out to local lakes for dives of up to 


have to select the best option 


in total. “Every step in the design, 
you search for solutions and you 
have to select the best option.” It 
wasn’t without its setbacks, either: 
“T burned quite [a few] parts, too, 
and some stuff I learned by trial and 
error. I managed to solder a LiPo 
[12V battery] connector the wrong 
way and the connector vaporised 
when I connected it to another LiPo 
by accident... No injuries, luckily.” 
Tucked safely inside the hull, the 
Raspberry Pi reads commands sent 
from the laptop via Ethernet, and 
controls the ROV’s brushless motors 
via ESCs. A single servo is used to tilt 


14m deep (youtu.be/-AUEswQq_ vo), 
although muddy water can make 
visibility tricky. “The lakes are dark, 
so I have powerful LEDs.” 

So, how deep could the ROV 
dive? According to Niels, a key 
limitation is the hull end-caps: 
“They will deflect too much when 
it goes deeper than 30m. | did an FE 
analysis at work to see the strains 
in the ROV, but | am not sure how it 
will behave in reality.” 

Niels’s ultimate dream is to use 
his ROV for exploration at sea, 
“where I can do a quick survey of 
shipwrecks before we go down 


SUBMERSIBLE DRONE 


Community 


| -s 


— 


me 


PROPELLER POWER 


with divers.” In the immediate future, 
he plans to use it to map the depth 

of lakes, using the echosounder and 
depth sensor while towing a surface 
GPS close behind. “I would also like to 
experiment with an autopilot, to make 
it into an AUV (automated unmanned 
vehicle) that can do a search pattern for 
lost items and come back to the surface 
to send the data to shore.” 


UNDERWATER 
CAMERA 
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magine you’re out at Sea, 
probably still near the 
coast. Possibly even in 
the harbour. Off to the side is a 
number of what look like model 
boats, racing around in a near- 
random pattern. At least, that’s 
what the human eye sees; in fact, 
you may be looking at a swarm 
of AI boats that are searching a 
specific square of sea, and their 
pattern makes for the most 
efficient area coverage that a 
person couldn’t calculate on 
the fly. This is a demonstration 
of swarm robotics, a field 
with not so much real-world 
research, according to one of the 
researchers on the team, PhD 
student Miguel Duarte. 

“Right now, the research 
has only been done in labs and 
Simulations, and our goal is to 
move that to the real world,” 


Above Final adjustments and tests, as one boat dreams of going 
out on the ocean 


Above The boats and code were built from scratch, and the whole 
thing took over a year 
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Some Portuguese students have created a 
Pi-powered AI drone swarm that can map 
and search bodies of water very efficiently 


Miguel explains to us. “So we have 
been trying for the past two years 
to make that happen, and this 

was the first instance of progress, 
or at least sizeable progress 

in that direction. 

“Before, we had a lot of 
experience with robots in the lab 
[at ISCTE - University Institute 
of Lisbon] and wanted to make 
this technology useful for the 
real world. These are first proof 
of concepts, basically, just 
to demonstrate our artificial 
intelligence algorithms work in 
the real world, because there’s 
been no demonstrations of these 
sort of algorithms that involve 
evolutionary computation and 
artificial neural networks.” 

The drones are built from 
Sciatelivame tie comirollen 
for them is a Raspberry Pi - 

a deliberate choice, as Miguel 
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A SEA OF ROBOTS 


The boats launch and are then sent 
instructions on where to start; the Al 
handles the rest 
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After a hard day's work, the boats return home 


to be collected and analysed by the team 


tells us:“There was no alternative 
in our minds: it was the first 
thing we considered and the first 
thing we used. For everything 

we have to do — ruin the control, 
read from the sensors, take care 
of communication, [and] save the 
loes to thes Dicana Sit cam ado eiat: 
very easily, and we don’t have 

to worry about the computing 
power. We had some experience 
with the Raspberry Pi before, and 
the fact we can actually interface 
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with hardware through the IO 


The title of this article comes from the original 

_ video the team made to show off the power of their 
_ drones in the Association for the Advancement 

_ of Artificial Intelligence (AAAI) 2016 competition. 

_ You can see the whole video presentation here: 

- youtu.be/JBrkszUnms8 

| 


ports, that was a winning combo... 


It simplifies our setup a lot.” 

It’s certainly a very impressive 
project and the code is already 
being used in other robots, which 
you can find out about here: 
magpi.cc/1VBi8ze. 

Hopefully, these autonomous 
Pi-powered boats will be able 
to improve the field of swarm 
robotics in the way the team want 
them to. 


The components are sealed in a waterproof box, 
as the salt water would not agree with them at all 
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OKC RASPBERRY PI 
MEETUP 


2 


RASPBERRY 


JAM 


Want to add your get-together? List it here: 


raspberrypl.org/jam/add 


RASPBERRY JAM: 
B&N HOLMDEL 


STAFFORD RASPBERRY JAM 

WITH CODE CLUB 

When: Wednesday 11 May 

Where: King Edward VI High 
School, Stafford, UK 

magpi.cc/1QkokjF 

This event is for Code Club 


When: Saturday 14 May 

Where: Edmond Baha’i Center, 
Edmond, OK, USA 

magpi.cc/1QkoPKI1 

With featured topics on 


this is the sixth OKC Raspberry 
Pigmmle enn: 
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volunteers, teachers, and members 
of the public interested in helping. 


OKC RASPBERRY PI MEETUP 


home automation and soldering, 


POTTON PI & PINTS: 


A RASPBERRY JAM DOUGHNUT 


When: Saturday 14 May 

Where: The Rising Sun pub, 
Potton, UK 

magpi.cc/1VzzZq7 

Fancy a chat with fellow 

geeks? Then ‘Potton Pi & Pints’ 

is for you. 


SWANSEA JAM 

When: Sunday 15 May 

Where: TechHub Swansea, 
Swansea, UK 

magpi.cc/1Qk2boy 

PiCymru is back with another 

Raspberry Jam event in Swansea, 

this time at TechHub’s new 

premises in the heart of the city. 


TWICKENHAM 

CODING EVENING MAY 

When: Thursday 19 May 

Where: Stokes and Moncreiff, 
London, UK 

magpi.cc/1VzBdSi 

For those who want to help support 

the teaching of coding as part of the 

new computing curriculum. 


RASPBERRY JAM: 

B&N HOLMDEL 

When: Saturday 21 May 

Where: Barnes and Noble Holmdel, 
Holmdel, NJ 

magpi.cc/1qZHeL9 

An informal Jam, looking to help 

beginners and those interested in 

the Pi to create and share ideas. 
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RASPBERRY JAM: 
SLICE OF Pi CLUB 


RASPBERRY JAM: 

SLICE OF PI CLUB 

When: Tuesday 24 May 

Where: Heart of Worcestershire 
CollleseRedditen, Uk 

magpi.cc/1VzBDIh 

Slice of Pi Club is set upto bring like— 

minded people together to learn about 

the wonderful world of the Pi. 


BLACKGANGPI 

When: Sunday 5 June 

Where: Ship Ashore Tea Room, Blackgang 
Chine, Isle of Wight, UK 

magpi.cc/1VzBKnl 

Show your projects and discuss with 

other Pi enthusiasts, and speak with the 

Blackgang and Robin Hill staff about 

how they use Pis in the theme park. 
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STAFFORD RASPBERRY 
JAM WITH CODE CLUB 


POTTON PI & PINTS: 
A RASPBERRY JAM DOUGHNUT 


TWICKENHAM 
CODING EVENING MAY 


- c) BLACKGANGPI 


DONT MISS: 


When: Sunday 5 June Where: Ship Ashore Tea Room, Blackgang Chine, 


This is where the dinosaurs 

were being hacked from our 
news piece earlier in the 
magazine. Blackgang Chine is 
the UK's oldest theme park, but 
it keeps itself modern. This time, 
it's qd general Jam where you can 
see demos and show off what 
you've done, all while enjoying a 
(hopefully) sunny day on the Isle 
of Wight. For more details, check 
out the event page: 
magpi.cc/1VZBKnl 


Isle of Wight, UK 
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Add a blueber ry Bee 


- J L'a fs 


slueberry 


Turn your Raspberry Pt 
into a Multi-Purpose 
lol Controller Board 


The Blueberry loT Controller for the 
Raspberry Pi is a versatile device designed 
to interact with the real world by reading 
sensors, controlling electrical equipment 


CONTROL 
gates, garage doors, air-conditioning, 
irrigation systems and much more. 


and using popular communication channels. 


lt is supported by a range of other devices 
which can turn your Raspberry Pi into 
the nerve centre of a simple or complex 


ae Use the power and connectivity of the Pi or the on-board 
monitoring and control system. 


GSM to control your system from anywhere in the world 
or receive reports and alerts via email or texts (SMS5). 


=Rapid www.rapidonline.com 


electronics Rapid Electronics part of the (QMWR4D Group 


Pi-DigiAMP+ 


* Raspberry Pi HAT, no soldering required =» Pi-DAC+ accessory, no soldering required * Raspberry Pi HAT, no soldering required 


* Full-HD Audio (up to 24bit/192MHz) ¢ Full-HD Audio (up to 24bit/192MHz) * Full-HD Audio (up to 24bit/192MHz) 

+ Texas Instruments PCM5122 * Texas Instruments TPA3118 * Texas Instruments TASS/756M 

* Variable output to 2.1v RMS « Up to 2x35w of stereo amplification * Up to 2x35w of stereo amplification 

* Headphone Amplifier / 3.5mm socket * Provides power to the Raspberry Pi * Out-of-the-box Raspbian support 

* Out-of-the-box Raspbian support * Software mute on GPIO22 * Integrated hardware volume control 

+ Integrated hardware volume control * Auto-Mute when using Pi-DAC+ headphones __* Provides power to the Raspberry Pi 

* Access to Raspberry Pi GPIO * Input voltage 12-19v * Software mute on GPIO22 

* Connect to your own Hi-Fi's line-in/aux * Supports speakers from 4-80hm * I/O (i2c, 3v, Sv, Ov, GPIO22/23/24/25) 
* Industry standard Phono (RCA) sockets + Just add speakers for a complete Hi-Fi 


* Supports the Pi-AMP+ * Input voltage 12-19v 
* Supports speakers from 4-80hm 


lQaudio Limited, 


Twitter: @IQ_audio Swindon, Wiltshire. 
Email: info@iqaudio.com WWW.IQAUDIO.COM Company No.: 9461908 


THE SECURITY CAMERA SOLUTION FOR THE 
RASPBERRY PI FROM SB COMPONENTS 


SPi-BOX is the first Raspberry Pi BASE KIT INCLUDES: 


case specifically designed to mount e SPi-BOX case (available in white or black) 


both the PIR and Raspberry Pi camera ¢ Instructions for setting up the security kit 


modules. The perfect solution for your « GPIO connectors 


PIR/camera project. * PIR module 


[=] F(a] Www. spi-box. co.uk ArSB Components we strive fo offer our customers the best 


prices for the best products. Our product team works firelessly to 


Call 0203 514 O914 - scurce top quality atfordable components from around the world. 


Raspberry Pi is a trademork of the Raspberry Pi Foundation. Raspberry Pi not included. *Compatible with Raspberry Pi 


STORAGE FOR PI. 
SPACE TO CREATE. 


Introducing WD PiDrive 314GB 


Promo Price 


Engineered for your ea} DIY projects 


Lower power consumption. With custom data 
recording and electrical design, the WD PiDrive 314GB is 
engineered to draw less power for use with Raspberry Pi. 


Fully customizable. Build storage-hungry projects to your 
desired needs, whether a media player, security camera 
or NAS. The WD PiDrive 314GB Is as versatile as your 
Raspberry PI. 


Free WDLabs Berryboot download for new users. 
Includes additional Raspberry Pi applications just for 
HDD storage usage. 


Learn more at wdlabs.wd.com/magpi314 
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More Pi upgrades 

A new Raspberry Pi, a new Compute Module, even 
a new case for the Raspberry Pi! I also hear there’s 
a newer version of the Pi Zero coming out. Are any 
of the other components expected to be updated 
this year? Is everything going to get a new version? 
Should I expect a Sense HAT 2 or a Camera 2 by the 
end of the year? Honestly, I love it: keeping it the 
same price, and having it work just the way things 
did before, makes it seem like you’re not missing 
out whether you upgrade or not! 


Sam Z 


Well, as you might have gathered from this issue 
of the magazine, the Pi Camera 2 did happen! 
Well done on guessing that. We don’t think 
loads of refreshes will be coming to some of the 
more ancillary Pi hardware; some of it is quite 


README md 


MagPiDownloader 


new, such as the Sense HAT you mentioned, and 
others wouldn’t really benefit from updates at the 
moment. This is probably just going to be a constant 
eradual process as tech comes and goes. Who knows 
where we’ll be in another four years! 


Raspberry Pi 4? 
I was quite amazed when the Raspberry Pi 3 was 
announced at the end of February, especially only a 
year after the Raspberry Pi 2 came out! I was actually 
looking to get another Raspberry Pi for some projects 
I had planned and the Pi 3 came along at just the right 
time for me, although the Pi 2 is still pretty great. 
I’m wondering, though, does that mean we should 
expect a yearly Raspberry Pi upgrade? I mean, I’d 
probably get them either way, but it’s nice to know 
if that’s sort of the plan going forward. Thanks! 
Edward Irons 


The new Pi 3 took us a bit by surprise as well when we 
heard about it, so we understand your concerns. Eben 
has made it clear, though, that the Pi won’t be released 
ona yearly cycle; on one hand it makes sure Raspberry 
Pi doesn’t get predictable, and on the other it ensures 
some of the other Pi products get an upgrade. We’ve 
already seen the Compute Module get a jump straight 
to the new chip, so hopefully we’ll get a new Model A 
as well, with a bit more oomph. 
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YOUR LETTERS MQQuT THT 


Digital downloads 

I’ve really liked reading your magazine over the 
past few months, so I finally decided to make the 
commitment and go for a full print subscription 
to the magazine. I do have a question, though: 
now that I have this print subscription, can I get 
access to the digital subscription as well: Hope 


you can help! 
Robin S 


KCL 0216 
KCL 85905 


1j-i1d 
-O8NS J 


a 


Thanks for subscribing - we really appreciate it! 
Unfortunately, we don’t have a system set up for 
people to get a digital subscription code with their 

print subscription, so we can’t help you there. We do gence leestlasea 
have an alternative, though - all issues of The MagPi 6-AbG-U8- 121 to skip the anole 
are free to download from our website as a PDF. Get a ene 
PDF reader on your phone or tablet, and you can have applaud you, but 
them on the go as well. They don’t take up much teattoenie babes ie 
space either! it out. 


Raspberry? i 
Comera V2.1 


Left Yep, there's 


back and check 


> = = ~~ 


FROM THE FORUM: 
EXPERTISE LEVEL 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving 
for the community - join in via raspberrypi.org/forums 


just bought my first Raspberry Pi and I them as understandable as possible. Some Have you got 
have zero programming experience. Ilike — projects will definitely be for more advanced Pi something 
the idea of subscribing to The MagPiforthe people, but we also have a lot that assume very you'd like 
projects and tutorials from more experienced users, _ little to no knowledge. For example, issue 36 to say? 
but I’m afraid it may be too advanced for me. has our ‘getting started’ guide. We also have Get in touch 
What kind of skill level is The MagPi aimed at? the Essentials series of books that cover a topic via magpi@ 
Is it appropriate for the inexperienced, or should I from beginning to end, so you can learn it as raspberrypi.org 
wait until I’ve advanced my knowledge and skills? you go. Best of all, they're all free as PDFs, so or on The 
FlightMedic you can give them a read and see if they’re to MagPi section 
your liking before grabbing a digital or physical of the forum at 
While we definitely have a wide range of projects subscription. You can learn all about the subs raspberrypi.org/ 
and tutorials in the magazine, we like to make here: magpi.cc/Subs1 forums 
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READ IT 


DO SCIENCE} 
SAVE YcENSF HAT 


with a Newsstand WITH OUR NEW 
panies ESSENTIALS 


iS AVAILABLE ON 


Potted j poh pita Doma THE MAGPI APP! 
POWER UP YOUR LIFE 
WITH RASPBERRY Pl 


CHAPTER UN E- 
WHAT IS THE 
mm SENSE HAT? 


AG;13237 DOWNLOAD ALL 30 ORIGINAL ISSUES 


The 


© 
( £2.29 » £26.99 


Magazine rolling subscription full year subscription 


Download it today - it’s free! 


Get all 30 legacy issues free 


for smartphones & tablets 


Instant downloads every month 


"IRA GETITON Fast rendering performance 
@ AppStore > Google Play _. . _ 


Live links & interactivity 
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Competition closes 23 May 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WORD 


’ 
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s I write this column, I’m on my way to 
Washington, DC for the USA Science and 
Engineering Festival, which is a three-day 
STEM-focused event for all ages. It happens every 
other year, and the organisers estimate that 

around 300,000 people course through the Walter 

E Washington Convention Center to get hands-on 
with new technology or learn a little bit of science. 
There, with a few other members of the Raspberry Pi 
team, we’re going to share our passion for computing 
and digital making with as many of those people 

as we can. Events like this one are an important 

part of getting the word out about our mission and 
our computer. 

Even though we’re constantly engaging with 
the Raspberry Pi community through our blog, the 
forums, on Twitter, and with The MagPi, there’s 
something special about seeing people face-to-face. 
Whether we’re chatting with a long-time Raspberry 
Pi user or are introducing someone to Raspberry Pi 
for the first time, it’s incredibly gratifying to speak to 
people about it in person. I feel so fortunate that I get 
to hear about so many projects, stories, and ideas. | 
especially love when I encounter someone who hasn’t 
heard of Raspberry Pi before. Their amazed reaction to 
our $35 computer is, well, priceless. 

At many events, we offer a hands-on activity so 
that people can try Raspberry Pi for the first time, or 
at least try something new with Raspberry Pi. We’ve 
had plenty of people come to our booth and write their 
first line of code, ever. It’s so much fun to see people’s 
reaction when they get their own ‘hello world’ 
message lighting up the LED matrix on the Sense HAT. 

At the SX Create event in Austin a few weeks ago, 
our Raspberry Pi stations were often packed with 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


9 MEETING 
" FACE TO FACE 


For Matt Richardson, seeing people in person is the best part of the job 


multiple kids at each setup. Parents would sometimes 
have trouble getting their children to step away from 
the Pi and see other activities at the event. For us, not 
only does it affirm that learning about computing can 
be fun and engaging, but it’s also a chance to observe 
the way young people interact with a Raspberry Pi. 


Varied audiences 

Every year, we try to reach lots of different audiences. 
At Maker Faires, we talk to families and hobbyists. 

At the BETT conference, we share our educational 
goals with British teachers. This summer, we’ll be 

at ALA for the first time, where we’ re introducing 
Raspberry Pi to American librarians at their 

national conference. 

Wherever we are, I encourage you to come out 
and see us if you can. Keep an eye on our events 
page (raspberrypi.org/education/events) or on 
our Twitter account for updates on where we’ I be. 
And, as a small incentive, we usually keep a stash 
of Raspberry Pi stickers to give away to people who 
stop by to say hello. 

Although we try to go to as many events as we 
possibly can, we can’t be everywhere, but that 
doesn’t mean you’re out of luck. If you want to 
meet IRL with your fellow Raspberry Pi community 
members, check for Raspberry Jams in your area 
(raspberrypi.org/jam). If you don’t see one, then 
that’s a perfect excuse to start your own. Raspberry 
Jams don’t have to be big affairs. In fact, they usually 
start off with just a few people. 

As much as we absolutely love the emails, tweets, 
and forum posts from our community, nothing 
can beat a handshake, a smile, and a conversation. 
Eventually, we hope to meet every single one of you! 
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“The FUZE is what NATIONAL 
- / the Raspberry Pi |iMajsay 
was designed for’ S==mrarsrm 


Protect your Pi from physical & static 
damage 


UK keyboard* & 4 Extra USB 
ports 


FUZE I/O Board with 40 
way GPIO pass-through 


Clearly labelled input 
Output ports 


2 Amp power supply and 
on/off switch! 


Adds analogue ports, 4 in & 1 out 


ae & & & & & & 


840 pin solderless breadboard (black) 


Reviewed model FUZE T2-R 


PC PRO Recommended ba mart 
... makes the Pi more EDITOR'S CHOICE 


BUY IT AWARD accessible than ever ... It's certainly the best 
we've ever tested 


Computer act!ve 


FUZE T2-C-SE 
* USA & German keyboard layouts are also BO IN U S 
available. Prices include VAT but not shipping - Includes 8GB SD pre- 


see fuze.co.uk for details 


configured with 
Technologies Ltd. Raspberry Pi and the Raspberry Logo FUZE BASIC 


are trademarks of the Raspberry Pi Foundation and are 
used with permission. All rights reserved. 


©2015 FUZE & the FUZE logo are trademarks of FUZE 


EXPERIMENT & 
‘Tae OF. NOE HAT 


Get started today for SENSE THE REAL WORLD WORLD 
just £2.99 / $3.99 vous haspberry Pi 


From the makers of the 
l official Raspberry P1 magazine 


Ma 
Available on the GET IT ON 
é App Store >> Google Play Find it on 


Ua @ 


sa app 


SENSE HAT? 


bal 


magpi.cc/Sense-HAT-book 


\ 
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Serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout FI Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditterential P’ 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. |?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 
Real-time clock with battery backup 
and 5V I°C level converter for adding 


external 5V I*C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 
1-Wire® to I?C host interface with ESD 


protection diode and |*C address 
selection. 


electronics 


NOW 
Available 
for the 
Pi Zero 
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“SAVE 


15% 
“MagPi15” 


discount code 


GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 


Connect hundreds of sensors 
to your Raspberry Pi! 


